Skip to content
FOSSBilling FOSSBilling FOSSBilling Docs

Building FOSSBilling

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

Prerequisites

Section titled “Prerequisites”

Build Steps

Section titled “Build Steps”

  1. Clone the repository

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

  2. Install PHP dependencies

    Terminal window
    composer install

  3. Install Node dependencies

    Terminal window
    npm install

  4. Build front-end assets

    Terminal window
    npm run build

  5. 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.

Development Mode

Section titled “Development Mode”

For active development:

Terminal window
npm run dev

This watches files and rebuilds automatically when you make changes.

Running Locally

Section titled “Running Locally”

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

Terminal window
cd src
php -S localhost:8000

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