Update procedure
Update the Qboxmail WHMCS module safely by replacing files, preserving configuration, and checking the installed version.
This page describes the procedure to follow to update the Qboxmail WHMCS module to the latest version, safely replacing the version already installed.
# Backup everything first
# backup data
cp -a modules/servers/Qboxmail modules/servers/Qboxmail.backup
# backup database
mysqldump -u user -p whmcs > whmcs-backup.sql
# Remove old version
cd modules/servers/
rm -rf Qboxmail/
# Upload new version to modules/servers/Qboxmail/
# and from v2.3.0
# Upload new addon in
# modules/addons/qboxmail_tools/
# Fix permissions if necessary (change www-data with your web server user:group)
chown -R www-data:www-data modules/servers/Qboxmail/ modules/addons/qboxmail_tools/
chmod -R 755 modules/servers/Qboxmail/ modules/addons/qboxmail_tools/
# Clear WHMCS template caches
rm -rf templates_c/*
# Activate the module from Admin → System Settings → Addon Modules → Qboxmail
# After activation setup Addons → Qboxmail for bundle config and domain import
# If upgrading from 2.2.0: delete old configurable option group first, then regenerate to get the new options (archive + sending capacity)
# 1. Go to **System Settings → Products/Services → Products/Services**
# 2. Edit your Qboxmail product
# 3. Go to **Module Settings** tab
# 4. Scroll to **Configurable Options** section
# 5. Click **Create Configurable Options**
# This creates quantity-based options. Set pricing per unit in **System Settings → Configurable Options**.
# Test the connection
# Admin: System → Servers → Test Connection
# Client: Access product details page