Skip to content

FOSS United Platform – Developer Guide

The FOSS United Platform is developed and maintained by the FOSS United Foundation, with ongoing contributions from the community. Development takes place on GitHub.

Note: We welcome contributions from developers. Join us by submitting issues, feature requests, or pull requests!

Installation Guide

Recommended Frappe Version: v15+

1. Prerequisites

If the kill command fails: 

ps aux | grep mysqld
sudo kill -9 <pid_of_mysqld> <pid_of_mysql_safe>

Ensure MySQL processes are fully stopped before restarting.

2. Setup Steps

# Create a new bench
bench init fossu-bench
cd fossu-bench

Install Newsletter App

The Newsletter module is now a separate app. Install it before fossunited:

bench get-app https://github.com/frappe/newsletter
bench install-app newsletter

Related discussion: #1120

Install FOSS United App

# Get the app
bench get-app https://github.com/fossunited/fossunited

# Create a new site
bench new-site test.localhost

# Install the app on the site
bench --site test.localhost install-app fossunited

# Start development server
bench start

To access the site in your browser, follow: Access Site via Browser

NixOS Setup

For those using NixOS, refer to this guide by @idlip: ==> Issue #1068 – NixOS Setup Guide

FOSS United Dashboard

The Dashboard is an admin UI for volunteers to manage activities across FOSS Clubs and City Chapters.

Dashboard Setup

# Go to the dashboard directory
cd fossunited/dashboard

# Install dependencies
yarn install

Required Configuration

In your site_config.json, add the following:

{
  "ignore_csrf": 1
}

Run the Dashboard

yarn dev

The dashboard will be available at: ==> http://<your-site-name>:8080

Pre-commit Hooks

To automatically run linters before commits:

pip install pre-commit
pre-commit install

Or use uv as an alternative Python package manager.

Happy hacking! If you face issues, open a GitHub issue or join the FOSS United community for help.