Common Webuzo Errors and Fixes

Webuzo simplifies application deployment on your Domain India 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 [email protected] or open a ticket at https://domainindia.com/support.