How to Install WordPress in cPanel with Softaculous

Softaculous is the fastest legitimate way to get WordPress running on cPanel hosting — no manual database creation, no hand-editing wp-config.php. But it's also easy to fire off an install, click through the fields without reading them, and end up with a broken site, a duplicate install fighting over the same folder, or a database error five minutes after "Installation Completed" flashes green. Here's how to do it right the first time, and how to fix it when it isn't.

What Softaculous Actually Does

Softaculous is an app installer bundled into most cPanel accounts, including Getwebup's shared and reseller hosting. When you install WordPress through it, it creates the MySQL database and user for you, writes wp-config.php with the right credentials, downloads WordPress core, and runs the setup wizard automatically. You skip roughly six manual steps and the chances of a typo in your database credentials.

It's not magic, though. It still depends on your account having free disk space, a healthy PHP version, and an empty (or intentionally chosen) install directory — which is where most of the problems below actually come from.

Before You Install: 3 Things to Check

• Your domain or subdomain is already pointed at this hosting account. If you just added the domain and DNS hasn't propagated yet, the install itself will still work — you just won't be able to preview the finished site on that domain until DNS catches up.
• The target directory is empty. Installing straight into public_html for your primary domain is normal. If you're adding WordPress to an addon domain or subdomain, know which folder Softaculous will write to before you start.
• PHP is on a supported version. Check MultiPHP Manager in cPanel and make sure the domain is set to PHP 8.1 or newer. Installing on an old PHP 7.x version is the single most common cause of a broken admin dashboard right after setup.

Step-by-Step: Installing WordPress via Softaculous

1. Log in to cPanel and open Softaculous Apps Installer (or click the WordPress icon directly under the Popular Installs section).
2. Click Install Now on the WordPress listing.
3. Choose Protocol: pick https:// if AutoSSL has already issued a certificate for the domain. If it hasn't yet, install on http:// and switch it in Settings once the certificate is live — don't force HTTPS before the cert exists, or you'll land on a mixed-content warning.
4. Choose Domain: select the exact domain or subdomain from the dropdown.
5. In Directory: leave this blank to install at the domain root. Only fill it in if you deliberately want WordPress in a subfolder like /blog.
6. Site Settings: set the site name and description (both editable later from wp-admin, so don't overthink this).
7. Admin Account: pick a real admin username — never admin — a strong generated password, and an email address you actually check. This account is the first thing bots try to brute-force, so make it count.
8. Advanced Options: change the database table prefix from the default wp_ to something random, and enable automatic backups if Softaculous offers them on your plan. Leave auto-upgrade for WordPress core turned on unless you have a specific reason to manage updates manually.
9. Click Install and wait. A clean install usually finishes in under a minute; on a busy shared server it can take a few minutes longer.
10. Once it's done, Softaculous shows both the site URL and the /wp-admin login URL. Save both before you navigate away.

Common Softaculous Install Errors and Fixes

"Home Directory is not writable"

Cause: file ownership or permissions on public_html got changed, often by a previous plugin, backup restore, or manual FTP upload.

Fix: in File Manager, right-click public_html → Permissions, and set it to 755. If that doesn't clear it, check with support whether the account hit its inode or disk quota — Softaculous can't write files it has no quota left to create.

"Script is already installed at the selected location"

Cause: leftover files from a previous install attempt, usually a failed one that didn't fully roll back. A stray wp-config.php or wp-load.php is enough to trigger this, even if the rest of WordPress never got installed.

Fix: check Softaculous → Installations tab first — if it lists a broken install, remove it from there rather than deleting files by hand. If nothing shows up in Softaculous but files are still in the folder, open File Manager, show hidden files, and delete everything in that directory before retrying.

Install finishes, but the site shows "Error establishing a database connection"

Cause: on a loaded shared server, Softaculous occasionally creates the database but the user-privilege grant doesn't fully commit before the install script moves on.

Fix: go to MySQL Databases in cPanel, confirm the database and user Softaculous created both exist, and check that the user is listed under that database with ALL PRIVILEGES. If the privilege is missing, add the user to the database manually and re-save. Then reload the site — no need to reinstall.

Site loads but wp-admin is blank or throws a 500 right after setup

Cause: almost always the domain's PHP version. Softaculous installs the current WordPress core, which expects PHP 8.1+; if the domain is still pinned to 7.4, core files load fine but admin-side functions fail.

Fix: open MultiPHP Manager, select the domain, and bump it to PHP 8.1 or 8.2. Reload wp-admin without changing anything else first — this alone resolves the majority of post-install 500s.

Install hangs at "Extracting Files" or times out

Cause: usually a disk quota that's nearly full, or a temporary hiccup pulling the WordPress package from wordpress.org.

Fix: check disk usage in cPanel's main dashboard. If there's headroom, just retry the install — Softaculous will clean up the partial attempt on its own in most cases. If it doesn't, remove the partial install from the Installations tab and start fresh.

Right After Install: Don't Skip These

• Set permalinks. Go to Settings → Permalinks and save once, even without changing anything — this writes the .htaccess rules WordPress needs for clean URLs.
• Confirm HTTPS end to end. If you installed on http:// and AutoSSL has since issued a cert, update Settings → General to https:// for both WordPress Address and Site Address, then run a search-and-replace if any content already has hardcoded http:// links.
• Delete the sample content. Remove the default "Hello World" post, the sample page, and the default comment — leaving them live looks unfinished to anyone who lands on the site early.
• Set the correct timezone under Settings → General so scheduled posts and logs match your actual time.
• Turn on real backups. Softaculous's own backup feature is fine as a safety net, but pair it with cPanel's full account backup so you're not relying on one system alone.

When to Skip Softaculous and Install Manually

Softaculous covers the overwhelming majority of cases, but there are a few where a manual install still makes sense: migrating an existing site with content already in place, setting up WordPress Multisite with a specific domain-mapping structure, or matching a database naming convention your team already standardizes on. For a brand-new site, though, there's no real downside to letting Softaculous handle the plumbing.