If you’re using Runcloud to manage your servers, you might encounter PHP applications that require the ionCube loader (e.g., some commercial scripts and encoded files). Installing ionCube manually can be tedious, but with this simple bash script, you can get it done in seconds.
Prerequisites
- A Runcloud‑managed server with SSH access.
- Root or sudo privileges.
- The server must have PHP installed (Runcloud typically uses PHP-FPM).
Step‑by‑Step Installation
Step 1: SSH into your server
Use your preferred terminal and log in as a user with sudo rights.
Step 2: Download the installation script
Run the following command to fetch the script from GitHub:
wget https://raw.githubusercontent.com/codetot-web/runcloud-bash-scripts/refs/heads/main/install-ioncube.sh
Step 3: Make the script executable
chmod +x install-ioncube.sh
Step 4: Execute the script
./install-ioncube.sh
The script will automatically detect your PHP version(s), download the appropriate ionCube loader, and place it in the correct extension directory.
Final result:
Downloading ionCube loaders…
Installing ionCube for OpenLiteSpeed PHP 8.1…
Installing ionCube for OpenLiteSpeed PHP 8.2…
Installing ionCube for OpenLiteSpeed PHP 8.3…
Installing ionCube for OpenLiteSpeed PHP 8.4…
Restarting OpenLiteSpeed services…
Verifying OpenLiteSpeed installation…
ionCube Loader
the ionCube PHP Loader
ionCube Loader
the ionCube PHP Loader
ionCube Loader
the ionCube PHP Loader
ionCube Loader
the ionCube PHP Loader
✅ ionCube installation completed for all detected PHP versions (OpenLiteSpeed & RunCloud/nginx).
Verify the installation
Create a info.php file in your web root with and look for the ionCube PHP Loader section.
Or run php -m | grep ionCube from the command line.
If you see ionCube listed, the installation was successful.
Important Notes
- This script is provided by me – always review scripts from the internet before running them.
- After installing ionCube, remember to remove the
phpinfo.phpfile for security. - If you have multiple PHP versions, the script should handle them all, but it’s wise to double‑check each one. The script should cover all of them.
- If you encounter any issues, make sure your PHP version is supported by ionCube (generally PHP 5.2 to 8.3) and that your Runcloud server has internet access to download the loader.


