Install FOSSBilling

Set up the database connection, create the first admin account, and choose the default billing options.


Step 1 - License Agreement
Step 2 - System Requirements

This environment meets the basic installation requirements.

Requirement Result
Operating system Linux
PHP version 8.5.6
PHP extension: curl OK
PHP extension: intl OK
PHP extension: openssl OK
PHP extension: pdo_mysql OK
PHP extension: xml OK
PHP extension: dom OK
PHP extension: iconv OK
PHP extension: json OK
PHP extension: zlib OK
PHP extension: gd OK
PHP extension: imagick WARN Optional: PDF image processing performance.
Step 3 - Database Connection

Enter the MySQL or MariaDB database details FOSSBilling should use.

Use the database service name in Docker environments, for example mariadb.
Step 4 - Admin Account

Create the first admin account. You will use this account to sign in to the admin area.

Password requirements:
  • Be at least 8 characters long
  • Contain at least one number
  • Contain at least one lowercase letter
  • Contain at least one uppercase letter
Step 5 - Options

Choose the primary currency for invoices, orders, and pricing. You can add more currencies later.

Optional. Learn more

Error reporting

Automated error reporting helps the FOSSBilling team identify defects and improve stability.

Reports are collected using Sentry.io and retained for up to 90 days under Sentry's security practices.

Data scrubbing and filtering are applied to reduce the chance of sensitive information being recorded.

See the FOSSBilling documentation for details about what is collected.