Troubleshooting

Troubleshooting Application Installation in Webuzo

By the Domain India teamPublished 9 min read
Knowledge base article
Contents (10 sections)

When a one-click install fails in Webuzo, the cause is nearly always one of a few things: the target folder isn't empty, the account has run out of disk space or databases, the app needs a newer PHP version than the account has, or the domain doesn't point to the server yet. This guide shows how to find which one it is and fix it on Domain India Webuzo hosting, and how to clean up after a half-finished install.

Key takeaways

Read the exact error Softaculous shows, then check four things: an empty target folder, free disk space, a free database slot in your plan, and the app's PHP requirement. Remove a failed install from Softaculous's installations list before retrying. On Webuzo shared hosting you can't restart services or change server settings, so anything server-side goes to support. Keep your own copy of anything important before you reinstall.

Related guides

For errors outside app installs (logins, email, SSL, 500 errors), see common Webuzo errors and fixes. For a normal WordPress install, see installing WordPress with Webuzo.

1. Which Webuzo do you have?

QuestionWebuzo shared hostingWebuzo on your own VPS
Who runs the serverDomain IndiaYou (the VPS is self-managed)
Restart services, change PHP builds, read server logsNo, ask supportYes, as root
What you can fixFolders, files, databases, app settingsEverything, including the server

Sections 2 to 7 are for shared hosting and mostly apply to a VPS too. Section 8 is only for a VPS you manage yourself.

2. Start with the exact error

Softaculous stops with a message that names the problem. Copy it word for word before you change anything; support will ask for it.

Error mentionsMost likely causeGo to
The directory is not empty, or an installation already existsOld files or an earlier install in the target folderSection 3
Disk quota, no space, could not extractAccount out of disk spaceSection 4
Database could not be created, database limitAll database slots used, or a leftover databaseSection 4
PHP version, required extensionThe app needs a newer PHP than the account hasSection 5
Install completes but the site shows another pageDNS, or an old index fileSection 6

3. "Directory not empty" or "installation already exists"

Softaculous refuses to install over existing files, so an old index.html, a previous site or a half-finished install blocks it.

  1. Check Softaculous's installations list.
    If an earlier install of the same app is listed for that domain and folder, remove it there. Softaculous asks whether to delete its files and database too.
  2. Check the folder in the File Manager.
    Open the target folder (usually public_html for the main domain) and look for leftover files, including hidden ones such as .htaccess.
  3. Move, don't delete, if unsure.
    Download anything you might need, or move it into a folder like old-site, then retry.
  4. Or install somewhere else.
    Choose a subfolder such as /blog in the install form if the main folder must keep its files.

4. Out of disk space or databases

Every install needs room to download and unpack the app, and nearly every app needs its own database.

PlanDiskWebsitesMySQL databases
Webuzo Starter10 GB NVMe15
Webuzo Developer30 GB NVMe510
Webuzo Agency100 GB NVMe5050

These are Domain India plan limits on 19 September 2026.

Webuzo Disk Usage page with a table of directories, their size and share of the disk space used
Disk Usage in Webuzo shows which folders take up space.

5. PHP version or extension errors

Each app in Softaculous lists the PHP version and extensions it needs, and current releases of some apps need recent PHP. If the app needs a newer version than your account offers, the install stops or the site fails straight after installing.

  • Read the requirement first. It is on the app's page in Softaculous, before you click Install.
  • Our Webuzo server offers PHP 8.0 and 8.1. Switch between them in MultiPHP Manager; an app that needs PHP 8.2 or newer won't run on Webuzo hosting. Don't try to change PHP with php_value lines in .htaccess: that gives a 500 error on our servers.
  • Consider an older release only if it is still supported by the app's developers. Never install an end-of-life version on a public site.

If you need a modern PHP stack for frameworks such as Laravel, cPanel hosting or a VPS is usually a better fit; ask support before you order.

Webuzo MultiPHP Manager listing example.com with its PHP Version dropdown and an Apply button
MultiPHP Manager shows the PHP version set for each domain.

6. The install finished but the site doesn't show

  • The domain doesn't point here yet. Until the domain's DNS points to your Webuzo hosting, visitors see the old host or an error. See how do I change my nameservers. DNS changes can take a few hours.
  • An old index file wins. If index.html is still in the folder, the web server may show it instead of the app. Remove or rename it.
  • You installed into a subfolder by mistake. Check the URL Softaculous shows at the end of the install.
  • "Error establishing a database connection". The database name, user, password or host in the app's config file (for WordPress, wp-config.php) doesn't match the panel. See installer could not find database and database troubleshooting.
  • A blank page or a 500 error. Check the app's error log in its folder. For WordPress, turn on WP_DEBUG_LOG briefly, and turn it off again when you are done.

7. Clean up and retry a failed install

  1. Remove the failed install
    from Softaculous's installations list, if it appears there, and let it delete the files and database.
  2. Check what's left.
    In the File Manager, remove leftover files in the target folder. In the database section, delete any empty database the install created.
  3. Fix the cause
    you found in sections 3 to 6.
  4. Retry once.
    If it fails again with the same message, stop and contact support.
Keep your own copy before you remove anything

Removing an install deletes its files and database. Download a copy of any site or database that matters before you remove or reinstall it. Domain India also backs up your account every night, and support can restore from those backups on request.

8. On your own VPS with Webuzo

A Domain India VPS is self-managed: you have root access and you are responsible for Webuzo and everything else on it. None of these commands work on shared hosting.

  • Disk space: df -h shows free space on each filesystem.
  • Database service: sudo systemctl status mysqld or mariadb, whichever your install uses; start it if it has stopped.
  • Webuzo service: find its exact name with systemctl list-units | grep -i webuzo, then check it with sudo systemctl status followed by that name.
  • PHP versions: install and select newer PHP builds from the Webuzo admin panel, following Webuzo's own documentation.

Starting, stopping or reinstalling the VPS itself is done by opening a ticket.

9. Where Domain India fits

Webuzo shared hosting suits a small site or a single WordPress install when you want a simple panel and don't want to run a server. For frameworks that need the newest PHP, or for several busy sites, compare cPanel hosting or a self-managed VPS. See the Webuzo plans on Webuzo hosting.

Webuzo Starter
₹100/mo + GST
  • 10 GB NVMe SSD Storage
  • 50 GB Monthly Bandwidth
  • 1 Website
  • 5 Email Accounts
See plan details

Prices on the cards exclude 18% GST.

Frequently asked questions

Why does Softaculous say the directory is not empty?

The target folder already has files, often an old index.html, a previous site or a half-finished install. Remove the old install from Softaculous's installations list, move or delete the leftover files, or install into a different folder, then try again.

Why does an app install fail with a database error on Webuzo?

Usually your plan's database limit is reached, often because failed installs left empty databases behind. Delete unused databases in the panel and retry. Webuzo Starter includes 5 MySQL databases, Webuzo Developer 10 and Webuzo Agency 50.

The app needs a newer PHP version. What do I do?

Check the app's PHP requirement on its Softaculous page before installing. Our Webuzo server offers PHP 8.0 and 8.1, which you can switch in MultiPHP Manager; an app that needs PHP 8.2 or newer needs cPanel or DirectAdmin hosting. PHP cannot be changed with php_value lines in .htaccess; that causes a 500 error.

Can I restart Apache, MySQL or Webuzo on shared hosting?

No. Domain India runs the server for Webuzo shared hosting, so contact support by live chat or a ticket for anything server-side. On your own VPS with Webuzo, you can restart services as root.

The install finished but I still see my old site. Why?

Either the domain's DNS still points to your old host, or an old index.html in the folder is being shown instead of the app. Check your nameservers or A record, and remove or rename old index files.

Should I take a backup before reinstalling an app?

Yes. Removing an install deletes its files and database. Download a copy of the site and database to your own computer first. Domain India also backs up your Webuzo account every night, and support can restore from those backups on request.

Ready to try again? Open the Webuzo panel from your hosting services using the Webuzo button, or open a ticket with the app name, the domain and the exact error message.

Install still failing?

Tell us the app, the domain and folder, and the exact error Softaculous showed, and we will check it with you.

Open a support ticket

Ready when you are

Get Webuzo hosting from ₹100/mo + GST

See plans

Was this article helpful?

Your answer helps us decide what to improve next.

Still need help? Open a support ticket and our team will reply.

Prefer an app? Add this site to your home screen.Get the app
Webuzo App Install Failed? Fixes for Softaculous Errors