WHMCS is a powerful and popular web hosting billing and automation platform. This guide provides a step-by-step process for installing WHMCS on Ubuntu 23.4, setting up the database, installing PHPMyAdmin, and completing the initial setup through the browser.


  • Ubuntu 23.4 server with root access
  • Web server (Apache or Nginx)
  • PHP 8.1 or later
  • MySQL database server
  • WHMCS license key

Step 1: Update System and Install Packages

Before proceeding, update the system and install necessary packages:

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget unzip git

Step 2: Install and Configure Web Server

For this guide, we’ll use Apache as the web server. Install and enable it:

sudo apt install -y apache2
sudo systemctl enable apache2
sudo systemctl start apache2

Step 3: Install PHP

Install PHP 8.1 and required modules:

sudo apt install -y php8.1 php8.1-mbstring php8.1-xml php8.1-gd php8.1-mysql

Step 4: Install and Configure MySQL

Install MySQL and secure it:

sudo apt install -y mysql-server
sudo mysql_secure_installation

Step 5: Create Database for WHMCS

Log in to MySQL:

mysql -u root -p

Create a database and user for WHMCS:

CREATE DATABASE whmcs_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER whmcs_user@localhost IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON whmcs_db.* TO whmcs_user@localhost;

Step 6: Install PHPMyAdmin

Install PHPMyAdmin for managing MySQL databases:

sudo apt install -y phpmyadmin

Follow the on-screen instructions to configure PHPMyAdmin.

Step 7: Download WHMCS

Download the latest WHMCS version:

wget https://download.whmcs.com/releases/latest/whmcs.zip

Step 8: Extract and Move WHMCS Files

Extract the downloaded file and move its contents to the web root directory:

unzip whmcs.zip
sudo mv whmcs/* /var/www/html/
sudo chown -R www-data:www-data /var/www/html/

Step 9: Install WHMCS from Browser

Open the web browser and navigate to your server’s IP address or domain name. The WHMCS installation wizard will start.

Follow the on-screen instructions to complete the installation process:

  • Select the “Standard Installation” type.
  • Enter the database details (name, user, password, host).
  • Enter your WHMCS license key.
  • Configure the system settings like company name, administrator details, etc.

Step 10: Secure WHMCS Installation

After completing the installation, perform the following security steps:

  • Delete the installation directory (/var/www/html/install).
  • Update WHMCS to the latest version.
  • Set up strong passwords for all WHMCS users.
  • Use a security plugin or firewall to protect your WHMCS installation.

Ioncube is part of whmcs and must be installed on the server.

Installing IonCube Loader on Ubuntu 23.4 for PHP 8.1 and 8.2

IonCube Loader is a necessary extension for running encoded PHP scripts and applications. This guide shows you how to install IonCube Loader on Ubuntu 23.4 for both PHP 8.1 and 8.2.


  • Ubuntu 23.4 server with root access
  • Web server (Apache or Nginx)
  • PHP 8.1 and/or PHP 8.2 installed

Step 1: Install Dependencies

First, update your system and install required packages:

sudo apt update && sudo apt upgrade -y
sudo apt install -y unzip curl

Step 2: Download IonCube Loader for PHP 8.1

Download the appropriate IonCube Loader version for PHP 8.1:

wget https://downloads.ioncube.com/loader_downloads/ioncube_loader_lin_8.1.x.zip

Step 3: Install IonCube Loader for PHP 8.1

Extract the downloaded file and copy the ioncube_loader_lin_8.1.x.so file to the appropriate extension directory:

unzip ioncube_loader_lin_8.1.x.zip
sudo cp ioncube_loader_lin_8.1.x.so /usr/lib/php/8.1/

Step 4: Edit PHP Configuration (PHP 8.1)

Open the php.ini configuration file for PHP 8.1:

sudo nano /etc/php/8.1/cli/php.ini
sudo nano /etc/php/8.1/apache2/php.ini

Add the following line at the end of the file:


Step 5: Restart Web Server (PHP 8.1)

Restart the web server to apply the changes:

sudo systemctl restart apache2

Step 6: (Optional) Install IonCube Loader for PHP 8.2 (Repeat steps 2-5)

If you also use PHP 8.2, repeat steps 2 to 5, but download the appropriate IonCube Loader version for PHP 8.2:

wget https://downloads.ioncube.com/loader_downloads/ioncube_loader_lin_8.2.x.zip

Replace 8.1.x.so with 8.2.x.so in the copy and configuration steps.

Step 7: Verify Installation

Create a simple PHP file named info.php with the following content:



Place the file in your web root directory and access it through your web browser. Scroll down to the “Loaded Extensions” section and ensure “IonCube Loader” is listed.


If you encounter problems loading IonCube Loader, check the following:

  • You downloaded the correct version for your PHP version.
  • The ioncube_loader.so file is in the correct extension directory.
  • The zend_extension line is added correctly to the php.ini file.
  • The web server has been restarted after making changes.

Congratulations! You have successfully installed and configured WHMCS on your Ubuntu 23.4 server. You can now manage your web hosting business efficiently with the powerful features of WHMCS.

Categorized in:


Last Update: December 9, 2023