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 {{COMPANY_NAME}} 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 {{SUPPORT_EMAIL}} or open a ticket at {{SUPPORT_URL}}.