Troubleshooting Application Installation in Webuzo

Webuzo makes it easy to install popular applications like WordPress, Joomla, and others with just a few clicks. However, installations can sometimes fail. This guide walks you through diagnosing and fixing the most common installation problems on your Domain India hosting.

Before You Begin

Every time an application installation fails, start by checking these three things:

1. Disk space: df -h (ensure at least 500MB free)
2. MySQL status: sudo systemctl status mysql
3. Webuzo logs: tail -100 /var/webuzo/log/webuzo.log

These cover the majority of installation failures.

Issue 1: Installation Hangs or Times Out

Symptoms

• Progress bar stays at a percentage indefinitely
• Browser shows a timeout error during installation

Causes and Solutions

Cause: Slow download speed

Webuzo downloads application files from external servers. If the download is slow:

1. Check your server's internet speed:

wget -O /dev/null http://speedtest.tele2.net/10MB.zip 2>&1 | tail -1

1. If the speed is very low, wait and retry. Some download mirrors may be temporarily slow.

Cause: PHP timeout

Increase PHP execution limits:

1. In Webuzo panel, go to PHP Settings
2. Increase these values:

- max_execution_time = 300

- max_input_time = 300

- memory_limit = 256M

1. Save and restart the web server

Cause: Webuzo service overloaded

Restart Webuzo and try again:

sudo /etc/init.d/webuzo restart

Issue 2: "Domain Already Exists" Error

Symptoms

• Error message states the domain is already configured
• Cannot install to a domain that previously had an application

Solutions

Remove the old installation:

1. In Webuzo panel, go to Installed Applications
2. Find the old installation and click Remove
3. Try installing again

If the domain is not listed in installed applications:

Manually clean up:

# Remove the domain's virtual host config
ls /etc/apache2/sites-enabled/ | grep yourdomain
sudo rm /etc/apache2/sites-enabled/yourdomain.conf

# Remove application files
rm -rf /home/webuzo/public_html/yourdomain/

# Restart Apache
sudo systemctl restart apache2

# Restart Webuzo
sudo /etc/init.d/webuzo restart

Issue 3: Database Creation Fails

Symptoms

• Installation fails at the database creation step
• Error: "Unable to create database" or "Access denied"

Solutions

Check MySQL is running:

sudo systemctl status mysql
sudo systemctl start mysql

Check MySQL disk space:

df -h /var/lib/mysql

Reset MySQL root password if needed:

sudo mysql
ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_secure_password';
FLUSH PRIVILEGES;
EXIT;

Then update the password in Webuzo:

1. Go to Databases > MySQL Root Password in Webuzo
2. Enter the new password

Check maximum database limit:

Your plan may have a database limit. Check in Databases > MySQL Databases how many databases exist.

Issue 4: WordPress Installation Issues

WordPress is the most commonly installed application. Here are WordPress-specific fixes:

wp-config.php Not Created

# Check if wp-config-sample.php exists
ls -la /home/webuzo/public_html/wp-config-sample.php

# Copy it manually if needed
cp /home/webuzo/public_html/wp-config-sample.php /home/webuzo/public_html/wp-config.php

Then edit wp-config.php with the correct database credentials from your Webuzo panel.

"Error Establishing a Database Connection" After Install

1. Verify database credentials in wp-config.php:

grep "DB_" /home/webuzo/public_html/wp-config.php

1. Test the connection:

mysql -u DBUSER -pDBPASS DBNAME

1. Fix if credentials are wrong -- update them in wp-config.php

White Screen After WordPress Install

Enable debug mode in wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Check the debug log:

tail -50 /home/webuzo/public_html/wp-content/debug.log

Issue 5: PHP Version Incompatibility

Symptoms

• Application requires PHP 8.0+ but server has PHP 7.x
• Deprecated function warnings or fatal errors

Solutions

1. Check current PHP version:

php -v

1. In Webuzo panel, go to PHP Settings
2. Install the required PHP version if not available
3. Switch to the required version
4. Verify the switch:

php -v

Check application requirements before installing. Most modern applications list their PHP requirements on their download page.

Issue 6: File Permission Errors During Installation

Symptoms

• Installation fails with "Permission denied" errors
• Cannot write files to the installation directory

Solutions

# Fix ownership of the web root
sudo chown -R webuzo:webuzo /home/webuzo/public_html/

# Set proper directory permissions
find /home/webuzo/public_html/ -type d -exec chmod 755 {} ;

# Set proper file permissions
find /home/webuzo/public_html/ -type f -exec chmod 644 {} ;

Check Apache/Nginx runs as the correct user:

grep -E "User|Group" /etc/apache2/apache2.conf

Issue 7: Application Not Accessible After Installation

Symptoms

• Installation completes successfully but the application shows a 404 or blank page
• Domain does not resolve to the application

Solutions

Check DNS configuration:

• Verify your domain's A record points to your VPS IP
• Use an online DNS checker to verify propagation

Check virtual host configuration:

sudo apache2ctl -S

Verify .htaccess file exists and has correct content:

ls -la /home/webuzo/public_html/.htaccess
cat /home/webuzo/public_html/.htaccess

Enable mod_rewrite if needed:

sudo a2enmod rewrite
sudo systemctl restart apache2

Reinstalling a Failed Application

If an installation failed partway through:

1. Remove partial files:

rm -rf /home/webuzo/public_html/application_directory/

1. Drop the created database (if any):

mysql -e "DROP DATABASE IF EXISTS dbname;"

1. Clear Webuzo cache:

rm -rf /var/webuzo/cache/*

1. Restart services:

sudo /etc/init.d/webuzo restart
sudo systemctl restart apache2
sudo systemctl restart mysql

1. Retry the installation from the Webuzo panel

Getting Installation Logs

When contacting support, include the following information:

1. Application name and version you tried to install
2. Error message (screenshot or exact text)
3. Webuzo log output:

tail -100 /var/webuzo/log/webuzo.log

1. PHP version: php -v
2. Disk space: df -h
3. MySQL status: sudo systemctl status mysql

Related Articles

• Common Webuzo Errors and Fixes
• Basic VPS Server Management Commands
• Monitoring VPS Resources (CPU, RAM, Disk)

Need help with an application installation? Contact our support team at [email protected] or open a ticket at https://domainindia.com/support.