How to install Softaculous script installer in cPanel shared hosting

Enable the Softaculous script installer module in your cPanel account to automate the deployment of popular web applications like WordPress, Drupal, and Joomla. These steps target cPanel 118.x and standard shared hosting environments where root access is unavailable. You will enable the module, configure the application settings, and verify that the installer is accessible.

Prerequisites

• cPanel account with root-level privileges (TLD owner or reseller).
• Active cPanel interface (version 118.x or later).
• Web browser with JavaScript enabled.
• Stable internet connection to download the installer package.

Step 1: Enable the Softaculous module

Log in to your cPanel control panel. Navigate to the Software section in the main menu and click on Softaculous Apps Installer. If you do not see this option, click the Advanced dropdown in the top right corner and select Softaculous Apps Installer from the list. The module may be hidden by default in some configurations.

Once the interface loads, you will see a list of available applications. To install the core Softaculous application, locate the entry labeled Softaculous in the list. Click the Install button next to the Softaculous entry. A confirmation dialog will appear asking if you want to proceed.

Click Install in the confirmation dialog. The system will begin downloading and installing the Softaculous application files. Wait for the progress bar to reach 100% and for the status to change to Installed. This process typically takes less than 30 seconds on a standard shared server.

Installing Softaculous...
Please wait...
Status: Installed

Step 2: Configure the Softaculous application

After the installation completes, click the Configure button next to the Softaculous application in the list. This opens the configuration page where you can adjust default settings for all scripts installed via Softaculous. Review the options presented in the configuration form.

Ensure that the Enable Softaculous checkbox is checked. This allows users to access the installer from their cPanel dashboard. If you have multiple domains or subdomains, you can select specific domains to restrict where Softaculous is available. Leave the default settings for the rest of the options unless you have specific security policies.

Click the Save button at the bottom of the page to apply the configuration changes. The system will save the settings immediately. You will see a confirmation message stating that the configuration has been updated successfully.

Configuration saved successfully.
The Softaculous application is now active.

Step 3: Access the Softaculous installer

Return to the main Softaculous dashboard by clicking Manage or the Softaculous Apps Installer link in the Software section. You will see a dashboard displaying available applications categorized by type, such as CMS, E-commerce, and Social Media. Scroll down to find the list of available scripts.

Locate the application you wish to install, such as WordPress. Click the Install button next to the application. A new installation form will appear. Fill in the required details, including the domain name, directory path, and admin username. Do not use the default admin username if you want to secure the installation.

Review the installation summary carefully. Ensure that the database name, user, and password are generated correctly. You can click Regenerate to create a new set of credentials if the current ones are not acceptable. Click Install to begin the deployment process.

Installing WordPress...
Database: wordpress_db
User: wordpress_user
Password: [Auto-generated]

Verify the installation

Open a web browser and navigate to your domain's Softaculous URL. The default URL is usually https://yourdomain.com/cpanel/softaculous or https://yourdomain.com/cpanel/apps. If you configured a custom path during installation, use that URL instead. You should see the Softaculous dashboard with a list of available applications.

Click on any application, such as WordPress, to verify that the installation wizard loads correctly. If the page loads without errors and displays the list of scripts, the installation is successful. Check that the Installed tab shows your previously installed applications.

https://yourdomain.com/cpanel/softaculous
Dashboard loaded successfully.
Available applications: WordPress, Joomla, Drupal...

Troubleshooting

If the Softaculous module does not appear in your cPanel Software section, verify that your cPanel version supports the module. cPanel 118.x and later versions include Softaculous by default. If you are on an older version, contact your hosting provider to enable the module or upgrade your account.

If you receive a permission denied error when trying to install an application, check the ownership of the softaculous directory. The directory must be owned by the cPanel user. Use the File Manager in cPanel to verify permissions. Ensure that the softaculous folder has 755 permissions and is owned by your user and group.

If the installer fails to connect to the database, verify that the database credentials are correct. Check that the database server is accessible and that the firewall is not blocking the connection. Ensure that the database engine is compatible with the application you are installing.

If the Softaculous interface displays a blank screen or JavaScript errors, clear your browser cache and try again. Disable any browser extensions that might interfere with the interface. Try accessing the installer from a different browser or device to rule out client-side issues.

If the installation process hangs or times out, check the server load. High CPU usage or memory exhaustion can cause installation failures. Wait for server load to decrease and try again. You can also check the Errors log in cPanel for specific error messages related to the Softaculous installation.

If you encounter issues with specific applications, consult the official Softaculous documentation for that application. Some applications require specific PHP versions or extensions. Ensure that your server meets the minimum requirements listed in the application documentation. Update your PHP version in cPanel if necessary.

Finally, ensure that your hosting provider has not disabled Softaculous due to security policies. Some providers restrict the installation of certain scripts to prevent abuse. Contact support if you suspect a policy violation. Follow their instructions to restore access or request an exception.