Common Webuzo Errors and Fixes

Webuzo simplifies application deployment on your {{COMPANY_NAME}} hosting, but you may occasionally encounter errors. This guide covers the most common Webuzo issues and their solutions.

1. Webuzo Panel Not Loading

Symptoms

• Browser shows "Unable to connect" or timeout when accessing the Webuzo panel
• Panel URL (http://YOUR_IP:2004 or https://YOUR_IP:2005) does not respond

Solutions

Check if the Webuzo service is running:

sudo /etc/init.d/webuzo status

Restart the Webuzo service:

sudo /etc/init.d/webuzo restart

Verify the port is open in your firewall:

# For UFW
sudo ufw allow 2004/tcp
sudo ufw allow 2005/tcp

# For iptables
sudo iptables -A INPUT -p tcp --dport 2004 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 2005 -j ACCEPT

Check if another service is using the port:

sudo ss -tulnp | grep 2004

Tip: Always access the Webuzo admin panel via HTTPS (port 2005) for security.

2. "Unable to Install Application" Error

Symptoms

• Application installation fails with a generic error
• Progress bar stops or shows an error message

Solutions

Check disk space:

df -h

Applications need sufficient disk space for both download and installation.

Check PHP version compatibility:

Some applications require specific PHP versions. In the Webuzo panel:

1. Go to PHP Settings
2. Verify the active PHP version meets the application requirements
3. Switch to a compatible version if needed

Clear the Webuzo cache:

rm -rf /var/webuzo/cache/*
sudo /etc/init.d/webuzo restart

Check Webuzo logs for details:

tail -50 /var/webuzo/log/webuzo.log

Verify MySQL is running:

Many applications require MySQL:

sudo systemctl status mysql
sudo systemctl start mysql

3. Database Connection Errors

Symptoms

• "Error establishing a database connection" on installed applications
• Applications show blank pages after installation

Solutions

Verify MySQL is running:

sudo systemctl status mysql

Check database credentials:

1. Log in to the Webuzo panel
2. Go to Databases > MySQL Databases
3. Verify the database name, username, and password
4. Cross-check with your application's configuration file

Test the database connection manually:

mysql -u dbuser -p dbname

Reset database password:

1. In Webuzo panel, go to Databases > MySQL Databases
2. Click on the database user
3. Set a new password
4. Update the password in your application's config file

4. Email Not Working

Symptoms

• Cannot send or receive emails
• Email forms on applications do not send

Solutions

Check if the mail service is running:

sudo systemctl status postfix
sudo systemctl start postfix

Verify DNS MX records:

• Ensure your domain's MX records point to your server
• Use an online MX lookup tool to verify

Check mail logs:

tail -50 /var/log/mail.log

If using a web application, configure it to use SMTP instead of PHP's mail() function for better reliability.

5. SSL Certificate Issues

Symptoms

• Browser shows "Not Secure" warning
• SSL certificate expired or invalid
• Mixed content warnings

Solutions

Install or renew Let's Encrypt SSL via Webuzo:

1. Log in to the Webuzo panel
2. Go to SSL > Let's Encrypt
3. Select your domain
4. Click Install or Renew

Verify DNS is pointing to your server:

SSL issuance requires your domain to resolve to your VPS IP.

Check certificate status:

openssl s_client -connect yourdomain.com:443 -servername yourdomain.com 2>/dev/null | openssl x509 -noout -dates

Force HTTPS redirect:

Add to your .htaccess file:

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

6. PHP Errors and Version Issues

Symptoms

• White/blank pages on applications
• PHP deprecated function warnings
• "Unsupported PHP version" errors

Solutions

Switch PHP version in Webuzo:

1. Go to PHP Settings in the Webuzo panel
2. Select the required PHP version
3. Click Save and restart the web server

Enable error display for debugging:

Add to your .htaccess or php.ini:

display_errors = On
error_reporting = E_ALL

Tip: Disable error display on production sites after debugging. Showing errors publicly can reveal sensitive information.

Install missing PHP extensions:

1. Go to PHP Settings > Extensions in Webuzo
2. Enable required extensions (e.g., curl, mbstring, gd, zip)
3. Restart the web server

7. File Permission Issues

Symptoms

• "403 Forbidden" errors
• Cannot upload files through application
• Application cannot write to directories

Solutions

# Set correct ownership
sudo chown -R webuzo:webuzo /home/webuzo/public_html/

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

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

# For writable directories (uploads, cache)
chmod 775 /home/webuzo/public_html/wp-content/uploads

8. Webuzo Update Failed

Symptoms

• Webuzo panel shows update available but update fails
• Panel behaves unexpectedly after update

Solutions

Manual update:

wget -N http://files.webuzo.com/install.sh
chmod 755 install.sh
./install.sh

Check for sufficient disk space before updating:

df -h

Useful Webuzo Paths

Related Articles

• Troubleshooting Application Installation in Webuzo
• Basic VPS Server Management Commands
• Common VPS Issues and Solutions

Need help resolving a Webuzo issue? Contact our support team at {{SUPPORT_EMAIL}} or open a ticket at {{SUPPORT_URL}}.