It is strongly recommended that a full backup of the system (13 or 14) be made prior to the upgrade steps below. If necessary, this backup can be used as a restore point to a new install. Note also that the new Backup and Restore module in FreePBX 15 allows restores of backups made by previous versions.
This wiki will describe the process to upgrade your FreePBX systems to latest FreePBX 15.
This section covers the FreePBX module and custom OSS brands on the top FreePBX upgrades to FreePBX 15.
For PBXact customers please refer to Upgrade to PBXact 15
Upgrade to FreePBX 15 from FreePBX 14
This section will describe the steps to upgrade FreePBX 14 to FreePBX 15.
How to install FreePBX upgrader tool
Please find below steps to install FreePBX upgrader tool.
Download PBX Upgrader tool from server
- Jump to "FreePBX GUI → Admin → Updates " section.
- Select "Module updates" tab from updates page and then click "check online"
- "Check online" will fetch the latest available modules from our mirror server and then it will display available modules.
Select "downloadall" and then "process".
- This will again ask for the confirmation to install latest version of PBX upgrader tool
- On confirmation this will install the module and will take you to module admin page.
Install PBX Upgrader tool manually
If PBX upgrader tool is not visible for you during "check online" functionality then you can follow below steps to install this manually.
- Navigate to your PBX, login and go to Module Admin
- Click “Upload Module”
- Make sure “Download from the web” is chosen and enter
http://mirror1.freepbx.org/modules/packages/versionupgrade/versionupgrade-14.0.12.tgz as the “Download Remote Module”
- Click download from web
- Go to Manage local modules
Install the new module (should show locally available.
How to use FreePBX upgrader tool
Please find below steps to upgrade your FreePBX 14 systems to FreePBX 15 using "PBX upgrader" tool.
- Select "FreePBX GUI → Admin → 14 to 15 Upgrade Tool"
- After selecting 14 to 15 Upgrade tool, below page will reopen where we can check the features of FreePBX-15 by expanding the tab or else move to next step by clicking "Check the requirements" button.
- You will see all passed validation as soon as "requirements check" process is over. Move to next step by clicking "Proceed to upgrade process".
- Upgrade process will start with below wizard. Click on "next" will start downloading new modules as per PBX 15 system.
- Step-2 of upgrade wizard will take some time so "do not refresh the web browser" and let the process to finish.
- If there is any error, it will show in the wizard. file permission is common error which needs to resolved by running "fwconsole chown" for example shown in below screenshot.
- This process will take some time due to downloading , installing all new FreePBX 15 modules.
Wizard will display the status and on successful completion it will ask you to "refresh" the page which will take you to module admin page.
- Upgrade to FreePBX-15 done successfully.
Upgrade to FreePBX 15 from FreePBX 13
Recommended path from FreePBX 13 to FreePBX-15 is to use "Backup & Restore" functionality to take Backup from working FreePBX-13 system and then restore to newly installed FreePBX-15 system.
We need to follow below steps to have up and running FreePBX-15 system with your same existing FreePBX-13 configuration.
- Take Backup of your FreePBX-13 System.
- Take full backup of your FreePBX-13 system using Backup & Restore module of FreePBX-13. Please refer to Using the Backup module for further details of how to configure and take full backup of your 13 system.
- Install FreePBX-15 on another server.
- Activate FreePBX-15
- Once FreePBX-15 installation is successfully over then activate your FreePBX-15 to ensure you will get latest updated modules. Please refer to System Admin - Activation to know more details about system activation process.
- Upgrade FreePBX-15 modules to latest
- After activation , FreePBX will show you the pop up with list of available updated modules to upgrade available modules or else you can check by yourself by using "Check Online" functionality. Please refer to Updates#ModuleUpdates for more details.
- Please note that Backup & Restore has been completely re-designed in FreePBX-15 so you might see differences in the way it used to work in FreePBX-13 vs FreePBX-15.
- Please refer to Backup and Restore FreePBX 15+ to know more about FreePBX-15 Backup & Restore module.
- We can restore the configurations by upload FreePBX-13 generated configuration backup to "FreePBX GUI → Admin → Backup & Restore → Restore tab".
- After successful restore , your FreePBX-13 is successfully replicated to new FreePBX-15.