Overview

The following guide will help you on how to install Softaculous on ISPConfig.

Note: Softaculous does not support Multi Server setup of ISPConfig Panel yet.

Requirements

  • A server with ISPConfig panel installed
  • Make sure you have created a Remote User in ISPConfig Control panel by going to the System tab and then click Add Remote User on the left
  • Access to Server, Client and All Site functions are required to the Remote User.
  • For ISPConfig 3.1+ make sure you have selected the Remote Access checkbox and added your server IP in Remote Access IPs/Hostnames textbox while adding the Remote User.
  • ionCube Loaders must be enabled
  • If you have firewall enabled, then please allow access to *.softaculous.com
  • suHOSIN must me disabled

    Make sure that the following PHP modules are enabled in loaded PHP binary:
  • mysqli/mysqlnd
  • curl
  • soap
  • posix
  • json
  • xml

Note : Please allow access to the following domains to your firewall as these are the mirrors used to download the script packages.

142.132.212.2 #api.softaculous.com
192.198.80.6 #s0.softaculous.com
158.69.6.246 #s1.softaculous.com
138.201.40.168 #s2.softaculous.com
213.239.208.58 #s3.softaculous.com
138.201.24.83 #s4.softaculous.com
148.251.137.79 #s5.softaculous.com
167.114.200.240 #s7.softaculous.com

Installing Softaculous in ISPConfig

Note: Before starting the installation make sure ionCube Loaders are enabled. Otherwise you will not be able to Install Softaculous. The ionCube Loaders can be downloaded at the ionCube Downloads page. 
Also Softaculous will not work if suHOSIN is enabled in your PHP

Now SSH to your server and enter following commands :

wget -N http://files.softaculous.com/install.sh
chmod 755 install.sh
./install.sh

Note : ./install.sh should be executed as root. So for ubuntu users add sudo before ./install.sh

The Installer will start showing the Installation Processes and when done will indicate the same. NOTE: Scripts will be downloaded during this process. The Download Activity will also be shown on the screen.

If the installation was successful you can visit the Softaculous panel after logging into the ISPConfig panel :

You can also visit http://YOUR_IP:PORT/softaculous to access Enduser Panel.

That’s it!! The installation of Softaculous is completed.

Set Remote Access setting for remote users

In order to access Softaculous in ISPConfig 3.1+, you need to enable the Remote Access as well as add your server IP in the Remote Access IPs/Hostnamestext field.

Quick Installation in ISPConfig

If you wish to finish the installation quickly and then download the script packages in background use this method.

Note: Before starting the installation make sure ionCube Loaders are enabled. Softaculous Installer requires Ioncube. Now SSH to your server and enter following commands:

wget -N http://files.softaculous.com/install.sh
chmod 755 install.sh
./install.sh --quick

Using Proxy settings

If you want Softaculous to use proxy settings then you can simply pass the parameters and Softaculous will use the proxy setting provided by you.

wget -N http://files.softaculous.com/install.sh
chmod 755 install.sh
./install.sh proxy proxy_ip=YOUR_IP:PORT proxy_auth=USERNAME:PASSWORD

Proxy Parameters  :

  • proxy_ip (Required) : Enter your Proxy server’s IP and port.
  • proxy_auth (optional) : Enter the proxy server’s authentication details i.e. Username and Password

Common Issue

Blank Page is displayed when Softaculous is accessed.

Problem : PHP Extension mysql and mysql.so is not loaded by Softaculous

Solution: Append the following lines in /usr/local/softaculous/php.ini

extension=mysql.so
extension=mysqli.so
extension=curl.so
extension=soap.so
extension=posix.so
extension=json.so
extension=xml.so
extension=ftp.so
extension=mbstring.so
extension=simplexml.so
extension=zip.so

Also create the directory /usr/local/softaculous/conf and create the file /usr/local/softaculous/conf/custom.ini with the same contents above. So when Softaculous is upgraded to newer version, it will check for php options added by user in custom.ini and will append the contents in new /usr/local/softaculous/php.ini

Note: If mysqlnd is enabled on your server, add it at the top of the above extensions list in php.ini file as:

extension=mysqlnd.so
extension=mysql.so
extension=mysqli.so
extension=curl.so
extension=soap.so
extension=posix.so
extension=json.so
extension=xml.so
extension=ftp.so
extension=mbstring.so
extension=simplexml.so
extension=zip.so

If ioncube not loaded : Install ioncube on debian

if blank page after install:

apt install php7.4-posix

For VestaCP:

/usr/local/vesta/bin/v-delete-vesta-softaculous
rm /usr/local/vesta/softaculous/vst_installed

/usr/local/vesta/ioncube/ioncube.sh

/usr/local/vesta/bin/v-add-vesta-softaculous

Leave a Reply