Restoring from Webuzo Backup

Webuzo allows you to restore your hosting account from previously created backups. This guide covers how to upload backup files and restore your website files, databases, and email accounts.

Accessing the Restore Feature

1. Log in to your Webuzo control panel
2. Navigate to Manage > Backups
3. You will see a list of available backup files on the server

Restoring from a Server-Side Backup

If your backup is already stored on the server:

Full Account Restore

1. Go to Manage > Backups
2. Find the backup file you want to restore from (identified by date)
3. Click the Restore button next to the backup
4. Select the components to restore:

- Home Directory — All website files

- MySQL Databases — All databases

- Email Accounts — Mailboxes and settings

- SSL Certificates — Certificate files

1. Click Restore to begin the process
2. Wait for the restoration to complete
3. A confirmation message will appear when finished

Tip: Before restoring, create a backup of your current state. This gives you a safety net if the restored backup does not resolve your issue.

Selective Restore

To restore only specific components:

1. Go to Manage > Backups
2. Click Restore next to the backup
3. Deselect components you do not want to restore
4. For example, select only MySQL Databases to restore databases without affecting files
5. Click Restore

Uploading and Restoring from a Local Backup

If you previously downloaded a backup to your local machine:

Step 1: Upload the Backup File

1. Go to Manage > Backups
2. Click Upload Backup or the upload button
3. Click Choose File and select the .tar.gz backup file from your computer
4. Click Upload
5. Wait for the upload to complete (this may take time for large files)

Step 2: Restore the Uploaded Backup

1. The uploaded backup will appear in the backup list
2. Click Restore next to the uploaded file
3. Select the components to restore
4. Click Restore to begin

Tip: If the upload keeps timing out due to file size, use FTP to upload the backup file to your accounts backup directory, then refresh the backup list in Webuzo.

Restoring a Database Manually

If you only need to restore a specific database from a SQL dump:

Via phpMyAdmin

1. Log in to phpMyAdmin from Webuzo
2. Select the target database (or create a new one)
3. Click Import
4. Click Choose File and select your .sql dump file
5. Set the format to SQL
6. Click Go to import

Via Command Line (SSH)

If you have SSH access:

mysql -u username -p database_name < backup_file.sql

Tip: For large database imports via phpMyAdmin, you may hit the upload size limit. Use SSH or increase the PHP upload limit in Webuzo settings.

Restoring Individual Files

If you need to recover specific files rather than a full restore:

1. Download the backup file to your computer
2. Extract the .tar.gz archive:

- Linux/Mac: tar -xzf backup_file.tar.gz

- Windows: Use 7-Zip or WinRAR

1. Locate the specific files you need in the extracted homedir/ directory
2. Upload them to your server using the Webuzo file manager or FTP
3. Place them in the correct directory path

After Restoring

Perform these checks after every restore:

1. Browse your website: Test all pages, forms, and functionality
2. Check database connections: Verify your CMS config file has the correct database credentials
3. Test email: Send and receive test emails
4. Check file permissions: Ensure files are 644 and directories are 755
5. Clear caches: Clear CMS caches, browser cache, and any CDN caches
6. Verify applications: Test any Webuzo-installed applications
7. Check cron jobs: Verify scheduled tasks are intact

Important Warnings

• Restoring is destructive: Selected components will be completely overwritten with backup data
• Data loss risk: Any changes made after the backup date will be lost for restored components
• Backup compatibility: Only restore backups created from the same Webuzo version or compatible versions
• Disk space: Ensure you have enough disk space for the restore operation

Troubleshooting

• Restore fails partway through: Check disk space. Free up space by deleting old backups or temporary files and try again.
• Website not working after restore: Check the CMS configuration file. Database credentials, paths, and URLs may need updating.
• "File not found" error on upload: Ensure the backup file is a valid .tar.gz archive. Re-download from your local storage if the file may be corrupted.
• Database restore fails: The database user may not exist. Create the database user in Webuzo first, then restore.
• Permissions errors after restore: Reset permissions: 644 for files, 755 for directories. Use the file manager or SSH.
• Large backup upload times out: Use FTP to upload the backup file instead of the web interface.

Related Articles

• Backing Up in Webuzo
• Webuzo Application Installer
• Webuzo File Manager Guide

Need help restoring from a backup? Contact {{COMPANY_NAME}} support at {{SUPPORT_EMAIL}} or open a ticket at {{SUPPORT_URL}}.