web-cp.net

"open source web hosting control panel"

← Back to Articles

Upgrading to Web-CP 0.8

2025-10-15 · Mike Reynolds guide upgrade

This guide covers upgrading to the web-cp 0.8 series from older versions. The 0.8 release includes breaking changes that require careful attention during the upgrade process.

Before You Begin

Back up everything. Before starting any upgrade:

# Backup web-cp files
sudo tar czf /root/webcp-backup-files.tar.gz /usr/local/webcp

# Backup database
mysqldump -u root -p webcp > /root/webcp-backup-db.sql

# Backup Apache configs
sudo tar czf /root/webcp-backup-apache.tar.gz /etc/apache2/sites-available/

Breaking Changes in 0.8

  1. PHP 8.1+ required — Versions below 8.1 are no longer supported
  2. Database schema changes — The upgrade script will modify several tables
  3. Config file format — Some configuration options have been renamed
  4. API authentication — If you used the old XML-RPC API, it has been replaced with REST

Upgrading from 0.7.x

This is the recommended upgrade path.

cd /usr/local/src
wget https://web-cp.net/downloads/web-cp-0.8.2.tar.gz
tar xzf web-cp-0.8.2.tar.gz
cd web-cp-0.8.2
sudo ./upgrade.sh

The upgrade script will:

  1. Detect your current version
  2. Check PHP version compatibility
  3. Run database migrations in sequence
  4. Update configuration files (preserving your customizations)
  5. Restart services

Upgrading from 0.6.x

If you’re running 0.6.x, you must first upgrade to 0.7.3 before proceeding to 0.8.x:

# First upgrade to 0.7.3
wget https://web-cp.net/downloads/web-cp-0.7.3.tar.gz
tar xzf web-cp-0.7.3.tar.gz
cd web-cp-0.7.3
sudo ./upgrade.sh

# Then upgrade to 0.8.2
cd /usr/local/src
wget https://web-cp.net/downloads/web-cp-0.8.2.tar.gz
tar xzf web-cp-0.8.2.tar.gz
cd web-cp-0.8.2
sudo ./upgrade.sh

Post-Upgrade Verification

After upgrading, verify that all services are running:

sudo /etc/init.d/webcp status

Check the upgrade log for any warnings:

cat /usr/local/webcp/logs/upgrade.log

Test basic functionality:

  • Log in to each control panel level
  • Create a test domain
  • Send a test email
  • Verify DNS resolution

Rolling Back

If something goes wrong, restore from your backup:

sudo /etc/init.d/webcp stop
sudo rm -rf /usr/local/webcp
sudo tar xzf /root/webcp-backup-files.tar.gz -C /
mysql -u root -p webcp < /root/webcp-backup-db.sql
sudo /etc/init.d/webcp start