Skip to main content
Version: 2.0

Upgrade

Upgrading Billing Booster takes two steps: overwrite the module files with the new release, then let WHMCS apply any database changes.

Back up first

Always back up your WHMCS files and database before upgrading any module. If something goes wrong, a clean restore is much faster than troubleshooting a half-applied upgrade.

1. Replace the files​

Upload the contents of the new release archive over your existing Billing Booster installation, overwriting:

/modules/addons/billboost
/modules/gateways/paycode
/modules/gateways/paycode.php
/templates/billboost-six
/templates/billboost-twenty-one
/templates/billboost-nexus
/templates/lagom2

Only overwrite the paths you actually installed — if you never used the billboost-* child themes, there is nothing to replace there.

note

Replace the existing files in place — do not delete the folders first. WHMCS keeps configuration in the database, so a file-level overwrite preserves all your payment codes, e-invoicing configurations, and processing settings.

2. Let WHMCS run the upgrade​

WHMCS notices that the addon's version has changed and runs Billing Booster's upgrade routine the next time you open Setup → Addon Modules. This applies any database changes.

There is no button to press. To confirm it ran, check that the version on the addon row matches the release you uploaded.

If you see "Class not found" or autoload errors afterwards, the file copy was incomplete or your opcache is stale — see Troubleshooting.

What's new

See the Changelog for the full list of changes in the latest release.

Upgrading from 1.x to 2.0​

Version 2.0 is built on a new shared core and a new interface, but it upgrades in place: your payment codes, e-invoicing configurations and settings are migrated by the upgrade routine above. Follow the same two steps.

Two things are worth knowing before you start:

  • Requirements have moved on. 2.0 needs WHMCS 8.11+, PHP 8.2+ and ionCube 13+. Activation refuses on an older WHMCS rather than half-installing.
  • BestPDF pairing. If you use BestPDF, 2.0 pairs with BestPDF 3.x. Upgrade Billing Booster first, then BestPDF — BestPDF's v2 design conversion reads your configured payment codes out of Billing Booster, and finds nothing if it isn't there yet. See BestPDF → Release notes.