Page tree
Skip to end of metadata
Go to start of metadata


The FreePBX GUI provides a module system that lets you upgrade FreePBX at anytime.  Please note upgrading FreePBX GUI will not upgrade any of your other applications like asterisk or your kernel.

Upgrading FreePBX Distro

Please follow the Upgrade Procedures outlined here for all FreePBX Distro Systems.

Upgrading to 13.0

FreePBX 13 is a special release that changes many of the backend functions, binaries and protocols. Therefore previously doing amportal commands won't work. The steps outlined below are exactly what is done in the GUI version upgrader

amportal a ma upgradeall
amportal a m
update admin set value = '13.0.0alpha1' where variable = 'version';
amportal a ma upgrade framework
fwconsole --fix_zend
fwconsole ma upgrade core
fwconsole ma disable backup
fwconsole ma download backup
fwconsole ma install backup

If you have commercial modules run this step

fwconsole ma upgrade sysadmin
fwconsole ma upgradeall
fwconsole chown
fwconsole reload

That should be it. Note: you may have to go through and re-enabled any broken modules and force them to upgrade manually

Upgrading to 2.10, 2.11 or 12.0

You will want to pull the release tarball, and follow the instructions below. Once you have installed it you will want to navigate to Module Admin menu item and update all modules as well as install other available modules not included in the release tarball.

amportal a ma upgrade framework
amportal a ma upgrade core
amportal a ma upgradeall

Upgrading to 2.6 From trixbox

If you are using a version of trixbox that no longer connects to the FreePBX repository and does not provide you with the 2.6 Upgrade Tool, you can upgrade to 2.6 by following these simple instructions. The process will simply install a special version of the Upgrade Tool and then you will upgrade just the same as the normal GUI upgrade process. Although the tool may indicate you are upgrading to a beta or release candidate program, since 2.6 has gone final, you will actually be upgraded to the current 2.6 released version. The steps are simply:

  1. Download the upgrade module to your desktop by pressing this link: Download trixbox Upgrade Tool
  2. Navigate to Module Admin in FreeBPX, click on the Upload module link and then browse to the module you downloaded in step 1, choose it, and then press upload.
  3. Now you simply install the module as if you were downloading it from the Online Repository and then you can follow the instructions provided by the module to upgrade!

The process is almost identical to pulling the module from our repository and once you do this, you will have access to all the great features and many bug fixes no present elsewhere.



  1. Typo: tar zxvf freepbx-

    Should be:tar zxvf freepbx-

    And: cd freepbx-

    Should be: cd freepbx

  2. I've come across several attemts to upgrade FreePBX from 12 to 13 unsuccessfully..

    If done manually, the upgrade steps run OK until the first fwconsole command:

    [root@pbx ~]# amportal a ma upgrade framework
    Please wait...
    Found module locally, verifying...Verified. Using Local
    Module framework successfully downloaded
    installing files to /var/www/html..done
    installing files to /var/lib/asterisk/bin..done
    installing files to /var/lib/asterisk/agi-bin..done
    Checking for upgrades..No further upgrades necessary
    framework file install done, removing packages from module
    file/directory: /var/www/html/admin/modules/framework/amp_conf removed successfully
    file/directory: /var/www/html/admin/modules/framework/upgrades removed successfully
    file/directory: /var/www/html/admin/modules/framework/libfreepbx.install.php removed successfully
    Generating CSS...Done
    Module framework successfully installed
    SETTING FILE PERMISSIONS.................Done
    Removing any dangling symlinks
    Dangling symlinks removed
    [root@pbx ~]# fwconsole --fix_zend
    -bash: fwconsole: command not found


    If done via GUI (registered system), on step #3 it breaks saying:

    Submitting data to servers...Done
    Running checks...Passed Stage 1 Bumping Paund PBX to version 13...Done Checking online servers...Done Downloading 13 Framework......Done Installing 13 Framework...Done ERROR: Try running this manually on the CLI to finish: 'amportal && fwconsole ma upgradeall'


    After the above, FreePBX ends completely broken, as the 'amportal' command can't se variables (directories) already present in asterisk configuration files, ge: 'astrundir':

    [root@pbx ~]# amportal && fwconsole ma upgradeall
    Please wait...
    astrundir in '/etc/asterisk' is set to but the directory
    does not exist. Attempting to create it with:
    'mkdir -p '
    mkdir: missing operand
    Try `mkdir --help' for more information.
    Attempt to execute 'mkdir -p ' failed with an exit code of 1
    You must create this directory and the try again.
    -bash: fwconsole: command not found
    [root@pbx ~]#


    After breaking our first PBX, we've tried several times with Virtual Machines: Every single time we get the same result.

    Any ideas??



    1. Please bring this conversation to the forums. Of note this works every single time in the distro and in PBX in a flash.

      Also not sure what "Paund PBX" is. Probably local modifications that are messing up the installer.

  3. Andrew,

    "Paund PBX" is just a cosmetic change which does not interfere with any system setting.

    I've trid again in a clean FreePBX (core 12.0.43) from scratch: Updated modules, installed module 'PBX Upgrader', reloaded config.

    Ran the '12 to 13 upgrade': same error, system went bricked and is unusable.

    NOTE: I'm not using FreePBX distro or FreePBX in a flash.- I've installed FreePBX 12 on CentOS 6.7 manually (as per thiese instructions) in all client platforms (that's why need to make sure the upgrade process works flawlessly before trying it in Production systems).


    1. Please stop commenting here for help. Use the forums.

      I've run all upgrade methods in here on multiple machines. I had no errors.

  4. I had to modify this to make it work for me.


    amportal a m
    update admin set value = '13.0.0alpha1' where variable = 'version';


    mysql -D asterisk -e "update admin set value = '13.0.0alpha1' where variable = 'version';"

    And if you have a mysql root password set then

    mysql -p -D asterisk -e "update admin set value = '13.0.0alpha1' where variable = 'version';"