Skip to content

Update Modules

UnifiedBX modules update independently of the system base. Run periodically to get bug fixes and security patches. Always backup first.

Before You Start

  • Recent backup exists (see Run a Backup).
  • Off-peak window — some module updates require an Apply Config that briefly drops calls.
  • Read the module's changelog if it's a major version bump.

Check for updates

  1. Go to System Admin → Modules (Module Admin).
  2. Click Check Online in the top toolbar. UnifiedBX queries Sangoma's update servers.
  3. Modules with updates are flagged in yellow; new modules are in green.

Update one or many modules

  1. Click the module to open it. The Action dropdown shows Upgrade to .
  2. Set Action = Upgrade.
  3. Repeat for each module to upgrade. (Or click Upgrade All at the top — riskier; do one critical-system module at a time if production.)
  4. Click Process at the bottom.
  5. Confirm.
  6. Wait for the install/upgrade to finish.
  7. Click Apply Config.

Updating commercial modules

Commercial modules require a valid license. Check System Admin → Activation (or Module Admin → System Updates) — if the license is expired or the system isn't registered, commercial updates won't proceed.

Verify

  • Check Modules for the new version listed.
  • Test a feature using the updated module.
  • Watch Reports → System Status for new errors.

Roll back a bad update

  1. Take a fresh backup BEFORE updating (preventive).
  2. If an update breaks something, restore the pre-update backup.
  3. Or in Modules, find the module and use Action → Downgrade (if previous version is cached locally).

Common Issues

  • "Cannot connect to update server." Outbound HTTPS to mirror.freepbx.org / sangoma.com blocked. Check firewall / DNS.
  • Module fails to install with dependency error. Update dependencies first, then retry. Or use Process which resolves dependencies.
  • Update succeeds but module disappears from menu. Module disabled itself due to error. Check Modules → Action = Enable.
  • Apply Config hangs after big update. First-run rebuild of dialplan can take minutes. Watch /var/log/asterisk/freepbx.log.