DebianServer Apps

How to Install FossBilling with Nginx on Debian 12

HomeDebianHow to Install FossBilling with Nginx on Debian 12

What is FossBilling?

FossBilling is an open-source billing and client management system designed for web hosting companies, freelancers, and digital service providers. It offers features for automated invoicing, client registration, domain and hosting management, payment gateway integration, and support ticketing—all within a self-hosted platform.

Running FossBilling with Nginx on Debian 12 (Bookworm) provides a secure, efficient, and customizable environment, ideal for businesses that want full control over their billing platform without relying on commercial software.

Key Features of FossBilling

  • Client and account management: Organize customer data, invoices, and services
  • Automated billing: Create and send invoices, handle recurring payments
  • Product & service sales: Sell hosting, domains, licenses, or digital services
  • Payment integrations: Supports Stripe, PayPal, CoinGate, and more
  • Support ticket system: Enable direct communication between clients and staff
  • Domain management: Integrates with popular domain registrars
  • Multi-language support: Available in various languages for global use
  • Theme and plugin system: Customize UI and extend core functionality

Why Use FossBilling with Nginx on Debian 12?

Debian 12 offers a stable and secure foundation for web applications like FossBilling, with:

  • Long-term support and security patches
  • Official access to PHP 8.2, which FossBilling requires
  • Clean, minimal system base—ideal for server deployments
  • Compatibility with MariaDB/MySQL, Nginx, PHP-FPM, and SSL certificates
  • Popular among VPS providers and cloud environments

System Requirements

ComponentRequirement
OSDebian 12 (Bookworm, 64-bit)
Web ServerNginx (preferred for performance)
PHP VersionPHP 8.1 or higher (8.2 recommended)
DatabaseMySQL or MariaDB
PHP Extensionspdo, mbstring, curl, openssl, xml, gd, zip, fileinfo, json
RAM512 MB minimum (1 GB+ recommended)
Disk Space500 MB minimum for base setup

Typical Use Cases

  • Hosting providers managing shared, VPS, or dedicated services
  • Freelancers handling digital product or subscription sales
  • SaaS startups with recurring billing needs
  • In-house tools for internal billing or client tracking
  • Agencies offering domain/hosting reselling with automated invoicing

Advantages of FossBilling on Debian 12 with Nginx

  • Free and open-source: Fully MIT licensed with no subscription fees
  • High performance: Nginx + PHP-FPM offers fast and lightweight request handling
  • Full control: Host it on your own infrastructure with customizable behavior
  • Active development: Continuously updated with community and developer contributions
  • Modern tech stack: Works well with Let’s Encrypt, Docker, and cloud hosting tools

Security Recommendations

  • Serve FossBilling over HTTPS using a valid SSL certificate
  • Store sensitive files outside the web root
  • Restrict admin access with IP allowlisting, firewalls, or VPN
  • Apply regular system and app updates
  • Monitor logs and server activity for anomalies
  • Use strong MySQL passwords and limit remote database access
  • Configure PHP-FPM for performance and isolation

FossBilling vs Alternatives

FeatureFossBillingWHMCSClientExecHostBill
License TypeFree (MIT)CommercialCommercialCommercial
Open SourceYesNoPartialNo
Payment Gateways10+80+LimitedExtensive
Domain Registrar SupportYesYesYesYes
Support TicketsIncludedIncludedIncludedIncluded
CustomizationHighModerateModerateHigh (paid)
Ideal ForStartups, DIYLarge resellersMid-size providersPremium providers

FossBilling with Nginx on Debian 12 is a powerful, cost-effective, and open-source alternative to commercial billing platforms. It’s easy to set up, highly customizable, and perfect for web hosting providers, freelancers, and digital service businesses that want full ownership of their infrastructure and client data.

With the security and stability of Debian 12 and the performance of Nginx, this stack offers a modern foundation for building and maintaining a reliable billing platform that meets the needs of both small and growing service providers.

Step 1: Create a Server Instance on Shape.Host

To get started, you’ll need a clean Debian 12 server. Here’s how to set one up using Shape.Host:

Visit https://shape.host and log in.

Click “Create”, then select “Instance”.

Choose your preferred data center location.

Set the OS to Debian 12 (64-bit).

Select a hosting plan with at least 2 CPUs, 4 GB RAM, and 20 GB SSD.

Click “Create Instance”.

Once ready, copy your IP address from the Resources tab.

Step 2: Connect to the Server

From a Linux/macOS terminal:

ssh root@your_server_ip

If you’re using Windows, download and connect via PuTTY.

Step 3: Install and Start Nginx

apt update
apt install nginx
systemctl start nginx
systemctl enable nginx
systemctl status nginx

This installs and starts the Nginx web server, enabling it to launch automatically at boot.

Step 4: Install and Set Up MariaDB

apt update
apt install mariadb-server
systemctl start mariadb
systemctl enable mariadb
systemctl status mariadb

MariaDB is the database system that will store your FossBilling data.

Step 5: Create the FossBilling Database

mariadb

Then enter the following SQL commands:

CREATE DATABASE fossdb;
CREATE USER fossdbuser@localhost IDENTIFIED BY 'type_new_password';
GRANT ALL ON fossdb.* TO fossdbuser@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;
exit

Replace 'type_new_password' with a strong password.

Step 6: Add PHP 8.3 Repository

apt install software-properties-common ca-certificates lsb-release apt-transport-https
echo "deb https://packages.sury.org/php/ bookworm main" > /etc/apt/sources.list.d/php.list
wget -qO - https://packages.sury.org/php/apt.gpg | tee /etc/apt/trusted.gpg.d/sury-php.gpg > /dev/null

This adds the Sury repository to get access to PHP 8.3.

Step 7: Install PHP 8.3 and Required Extensions

apt update
apt install php8.3-fpm php8.3-intl php8.3-mysql php8.3-curl php8.3-cli php8.3-zip php8.3-common php8.3-mbstring php8.3-xml
php -v
systemctl start php8.3-fpm
systemctl enable php8.3-fpm

These packages are required for FossBilling to function correctly.

Step 8: Download and Unpack FossBilling

cd /tmp
apt install curl unzip
curl https://fossbilling.org/downloads/stable -L --output FOSSBilling.zip
mkdir -p /var/www/fossbilling
unzip FOSSBilling.zip -d /var/www/fossbilling
chown -R www-data:www-data /var/www/fossbilling

This downloads and prepares FossBilling files inside your web directory.

Step 9: Configure Nginx for FossBilling

nano /etc/nginx/sites-available/fossbilling.conf

Paste the following config (replace fossbilling.example.com with your domain):

server {
    listen 80;

    set $root_path '/var/www/fossbilling';
    server_name example.com;

    index index.html index.htm index.php;
    root $root_path;
    try_files $uri $uri/ @rewrite;
    sendfile off;

    include /etc/nginx/mime.types;

    location ~* .(ini|sh|inc|bak|twig|sql)$ {
        return 404;
    }

    location ~ /\.(?!well-known\/) {
        return 404;
    }

    location ~* /uploads/.*\.php$ {
        return 404;
    }

    location ~* /data/ {
        return 404;
    }

    location @rewrite {
        rewrite ^/page/(.*)$ /index.php?_url=/custompages/$1;
        rewrite ^/(.*)$ /index.php?_url=/$1;
    }

    location ~ \.php {
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param PATH_INFO       $fastcgi_path_info;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_intercept_errors on;
        include fastcgi_params;
    }

    location ~* ^/(css|img|js|flv|swf|download)/(.+)$ {
        root $root_path;
        expires off;
    }
}

Activate the site and reload Nginx:

ln -s /etc/nginx/sites-available/fossbilling.conf /etc/nginx/sites-enabled/
systemctl restart nginx

Step 10: Install Additional PHP Tools

apt install php8.3-gd php8.3-imagick php8.3-bz2 -y
apt install imagemagick -y
systemctl restart php8.3-fpm
systemctl restart nginx

These modules help with image handling and file compression in invoices or client uploads.

Step 11: Finalize Web Installer & Secure Files

After completing the FossBilling setup in your browser:

rm -rfv /var/www/fossbilling/install
chmod 644 /var/www/fossbilling/config.php

This removes the install script and sets secure permissions for your config file.

Step 12: Add the Cron Job

FossBilling relies on scheduled tasks for automation:

crontab -u www-data -e

Paste the cron job recommended by FossBilling (you’ll see it in the admin panel).

✅ Installation Complete!

Now you can open your browser and go to:

http://your-server-ip

Or, if using a domain:

http://fossbilling.example.com

Follow the web-based installer to finish the setup.

Follow the setup wizard in your browser to finish configuration.

Click Next to continue.

Type in the database name and user account created above and click Next.

Create an administrator account and click Next.

Finally, run the commands below to remove the installation directory and configure a cron job. Then click Finish.

sudo rm -rf /var/www/fossbilling/install
sudo chmod 0644 /var/www/fossbilling/config.php
sudo crontab -u www-data -e
*/5 * * * * php /var/www/fossbilling/cron.php

Login to the dashboard using the credentials created above.

With Shape.Host, you get:

  • Fast, reliable Cloud VPS servers
  • Clean Debian 12 environment for web hosting
  • Easy instance deployment
  • Full root access

Start your FossBilling journey today at https://shape.host

Tags:
Christian Wells

Older Post

How to Install FossBilling with Nginx on Ubuntu 24.04

Next Post

How to Install .NET SDK and .NET Runtime on Ubuntu 24.04

Related Product

How to Deploy MERN Stack Web App on Ubuntu 24.04

How to Install FossBilling with Nginx on Debian 12