Web Server
Section titled “Web Server”FOSSBilling works with any of these:
- Apache (with
mod_rewriteenabled) - LiteSpeed Web Server
- NGINX — see our recommended config
- OpenLiteSpeed — note: may not be ideal if you're selling web hosting (FOSSBilling itself runs fine)
Our recommendation: Apache or Apache behind an NGINX reverse proxy (handling static files). Most control panels are set up this way by default.
If you're using something else, you'll need to configure URL rewriting manually. Use one of our existing configurations as a reference.
Supported Versions
Section titled “Supported Versions”- 8.2, 8.3, or 8.4
Required Extensions
Section titled “Required Extensions”These must be installed:
curldomiconvintljsonopensslpdo_mysqlxmlzlib
Recommended Extensions
Section titled “Recommended Extensions”Install these for better performance and features:
| Extension | Why You Want It |
|---|---|
mbstring | Proper handling of multibyte characters |
opcache | Highly recommended — significantly improves performance |
imagick or gd | Image processing for logos and PDFs |
bz2 | Extract .tar.bz2 archives (module/theme installs) |
simplexml | Required for the Plesk integration only |
PHP Configuration
Section titled “PHP Configuration”Edit your php.ini:
memory_limit: At least64M. Increase if you run many modules or have high traffic.max_execution_time: Default30seconds is usually fine. Increase to45–60on shared hosting if needed.allow_url_fopen: Set toOnif you need remote images in PDFs or emails.
Database
Section titled “Database”FOSSBilling requires a MySQL-compatible database:
- MySQL 8.0 or newer
- MariaDB 10.3 or newer
Quick Checklist
Section titled “Quick Checklist”Before installing, verify:
- [ ] Web server running with rewrite support
- [ ] PHP 8.2–8.4 installed with required extensions
- [ ] MySQL 8.0+ or MariaDB 10.3+ available
- [ ] Database and user created with appropriate privileges