Docker Installation

Prerequisites

• Docker Engine installed on your system

Choose a Setup

Note

Use the latest tag for the current stable release.

Standalone

The simplest option. This runs only the FOSSBilling container, so you must provide your own database service.

docker run -d \
  --name fossbilling \
  -p 80:80 \
  -v fossbilling:/var/www/html \
  --restart unless-stopped \
  fossbilling/fossbilling:latest

Then open your server IP or hostname in a browser to complete the web installer.

Docker Compose

This option brings up FOSSBilling and MariaDB together, which makes it the fastest way to get started.

docker-compose.yml

services:
  fossbilling:
    image: fossbilling/fossbilling:latest
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - fossbilling:/var/www/html
    depends_on:
      - mariadb

  mariadb:
    image: mariadb:lts
    restart: unless-stopped
    environment:
      MARIADB_DATABASE: fossbilling
      MARIADB_USER: fossbilling
      MARIADB_PASSWORD: ${MARIADB_PASSWORD:?set-a-strong-database-password}
      MARIADB_RANDOM_ROOT_PASSWORD: "1"
    volumes:
      - mariadb:/var/lib/mysql

volumes:
  fossbilling:
  mariadb:

Run it:

docker compose up -d

The first startup downloads container images, so it may take a few minutes.

Before starting the stack, set a strong database password:

export MARIADB_PASSWORD="$(openssl rand -base64 32)"

Database credentials (if using the example above):

• Hostname: mariadb
• Database: fossbilling
• Username: fossbilling
• Password: the value of MARIADB_PASSWORD

Open http://localhost or your server's IP/hostname to continue with the installer.

Post-Installation

The official Docker image runs FOSSBilling cron automatically every five minutes inside the container.

You do not need to add a host crontab entry when using the official Docker image.