Building FOSSBilling

Build FOSSBilling from source when you want to contribute code, test changes locally, or package a customized version.

Prerequisites

Build Steps

Clone the repository

git clone https://github.com/FOSSBilling/FOSSBilling.git
cd FOSSBilling

Install PHP dependencies
Terminal window
```
composer install
```
Install Node dependencies
Terminal window
```
npm install
```
Build front-end assets
FOSSBilling uses esbuild. Run the build:
Terminal window
```
npm run build
```
This builds the shared frontend assets into src/public/assets and builds the bundled admin_default and huraga theme assets.
Add translations (optional)
Download the latest translations and extract to src/locale/, overwriting existing files.

After these steps, your checkout is ready for local development or for packaging into a deployment build.

Developer Tooling

FOSSBilling bundles its development and CI tooling as a single console package in tools/. The tools package requires PHP 8.5 — a tighter requirement than FOSSBilling itself. After installing dependencies, the commands are available via:

composer install --working-dir=tools
tools/bin/console list

This provides manifest:validate (validates bundled module manifests), i18n:* commands (translation extraction used by the locale repository's workflows), and demo:seed (populates an install with demo data).

Development Mode

For active theme development, use the theme workspace scripts:

npm run build-admin_default
npm run build-huraga

The Huraga theme also supports watch mode:

cd src/themes/huraga
npm run dev

Running Locally

You can use PHP's built-in server for quick testing:

cd src
php -S localhost:8000

Then visit http://localhost:8000 in your browser.