How to Install BoxBilling on AlmaLinux 9

Estimated reading: 4 minutes 905 views

Introduction

This guide explains how to install BoxBilling on AlmaLinux 9 using Apache, MariaDB, and PHP. The goal is to provide a clean, step-by-step process for beginners while preserving all commands exactly as written. Each command is followed by a short explanation to help you understand what it does without altering the installation flow.

Prerequisites

Before starting, ensure you have the following:

  • AlmaLinux 9 server (fresh or cleanly configured)
  • Root or sudo privileges
  • A domain or IP pointing to the server
  • Basic familiarity with Linux commands

Step 1: Update the System

Command:

dnf update

Description:

Updates all system packages to their latest versions to ensure your server is secure and ready for new software.

Step 2: Install Apache Web Server

Command:

dnf install httpd

Installs the Apache web server, which will serve BoxBilling’s web interface.

systemctl enable --now httpd

Enables Apache to start at boot and starts the service immediately.

Step 3: Install MariaDB

Command:

dnf install mariadb-server mariadb

Installs MariaDB server and client packages to provide the database backend for BoxBilling.

systemctl enable --now mariadb

Starts MariaDB now and configures it to start automatically on system boot.

Step 4: Install EPEL Repository

Command:

dnf install epel-release

Adds the EPEL software repository, which provides additional packages needed on Enterprise Linux systems.

Step 5: Add Remi Repository for PHP 8.2

Command:

dnf install https://rpms.remirepo.net/enterprise/remi-release-9.rpm

Installs the Remi repository that includes updated PHP versions required by BoxBilling.

dnf module reset php

Resets the default PHP module to allow switching versions.

dnf module enable php:remi-8.2

Enables PHP 8.2 from Remi, ensuring compatibility with BoxBilling.

Step 6: Install PHP and Required Extensions

Command:

dnf install php php-cli php-mysqlnd php-curl php-mbstring php-xml php-gd php-zip php-imagick unzip wget

Installs PHP 8.2 and all extensions needed for BoxBilling, along with unzip (for extracting archives) and wget (for downloading files).

systemctl restart httpd

Restarts Apache so it can load the PHP module.

Step 7: Secure MariaDB Installation

Command:

mysql_secure_installation

Description:

Runs an interactive script to secure MariaDB by setting a root password and removing insecure defaults.

Step 8: Create Database and User

Command:

mysql -u root -p

Logs in to MariaDB as the root user.

Inside the MySQL prompt, run the following exact commands:

CREATE DATABASE boxbilling_db;

Creates the database for BoxBilling.

CREATE USER 'boxbilling_user'@'localhost' IDENTIFIED BY 'StrongPassword123!';

Creates a dedicated user with a strong password.

GRANT ALL PRIVILEGES ON boxbilling_db.* TO 'boxbilling_user'@'localhost';

Grants full access to the BoxBilling database.

FLUSH PRIVILEGES;
EXIT;

Applies your changes and exits the database shell.

Step 9: Download and Extract BoxBilling

Command:

cd /var/www/html

Moves to Apache’s default web root directory.

wget https://github.com/boxbilling/boxbilling/releases/latest/download/boxbilling.zip -O boxbilling.zip

Downloads the latest BoxBilling release from GitHub.

unzip boxbilling.zip -d boxbilling

Extracts BoxBilling into a folder named boxbilling.

chown -R apache:apache /var/www/html/boxbilling

Assigns ownership of BoxBilling files to Apache.

chmod -R 755 /var/www/html/boxbilling

Sets appropriate permissions so Apache can read and execute files.

Step 10: Configure Apache Virtual Host

Command:

nano /etc/httpd/conf.d/boxbilling.conf

Opens a new Apache configuration file.

Paste the following:

<VirtualHost *:80>
ServerName yourdomain.com
DocumentRoot /var/www/html/boxbilling<Directory /var/www/html/boxbilling>
AllowOverride All
Require all granted
</Directory>

ErrorLog /var/log/httpd/boxbilling_error.log
CustomLog /var/log/httpd/boxbilling_access.log combined
</VirtualHost>

Defines how Apache serves the BoxBilling website.

systemctl restart httpd

Applies the configuration by restarting Apache.

Step 11: Adjust PHP Settings

Command:

nano /etc/php.ini

Opens the PHP configuration file.

Modify or add the following lines:

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300

Increases resource limits to ensure smooth BoxBilling operation.

systemctl restart httpd

Applies the PHP configuration changes.

Step 12: Create Data Directories

Command:

mkdir -p /var/www/html/boxbilling/bb-data/cache
mkdir -p /var/www/html/boxbilling/bb-data/uploads

Creates required directories for BoxBilling.

chown -R apache:apache /var/www/html/boxbilling/bb-data

Gives Apache ownership of the data directory.

chmod -R 775 /var/www/html/boxbilling/bb-data

Ensures proper write permissions.

Step 13: Verify Installation

After uploading and configuring all files, open:

http://yourdomain.com/install/install.php

The installer will walk you through:

  1. Preparation

  2. Database configuration

  3. Admin account setup

  4. Finalization (remove install directory and set bb-config.php to 644)

You can then log in at:

http://yourdomain.com/bb-admin

Conclusion

You have now installed BoxBilling on AlmaLinux 9 using Apache, MariaDB, and PHP 8.2.
This setup allows you to run a stable and efficient billing platform.
All commands were preserved exactly as provided while adding clear explanations to make the installation process easy to follow.

Share this Doc

How to Install BoxBilling on AlmaLinux 9

Or copy link

CONTENTS

Powered By EazyDocs