Install using Docker

Install using Docker

This guide is incomplete. Please help us complete it using the "Edit this page" button in the sidebar. Thanks!

We also are planning to do changes to the installation process. You might want to check back later.

This guide will build FOSSBilling from the main branch. It should be okay if you're planning to use it for testing or development. Be careful when using in production.

But wait... What is Docker?

Docker containers isolate the app from the host system and solve the "it works on my machine" headache. With this method, everyone using Docker runs virtually the same environment as the others. This is a great way to ensure that everyone has the same environment, thus making it less likely to have problems.

Docker also lets you run multiple containers on the same machine with different configurations. To learn more about containers, we strongly advise you to read Docker's explanation (opens in a new tab) first.


Before going further, please make sure you have Git, Docker Engine, Docker Compose and GNU Make (opens in a new tab) installed. Git and GNU Make will likely come pre-installed on most Linux distributions. To install the Docker Engine, visit Docker's installation page (opens in a new tab). To install Docker Compose, visit Docker's compose installation page (opens in a new tab).

Also make sure you have root access to the server.

Clone the repository

To get started, you need to clone the repository first. Cloning will download the latest version of our source code. You can do this by running the following command:

git clone

Navigate to the cloned directory

You can now navigate to the cloned directory by running the following command:

cd fossbilling

Run the installation script

To use the installer, you need to be a superuser. Switch to the root user using sudo su or add the sudo prefix to the next command.

To start our installer script, run the following command:

make all

Post-installation steps

Last updated on December 5, 2022