Upgrading FreePBX 2.11 Distro to FreePBX 12 and Asterisk 13


This tutorial will help you upgrade your FreePBX 2.11 Distro to FreePBX 12.

At the end of this tutorial, you should have FreePBX 12 and Asterisk 13 fully working on your CentOS system.

Step One — Making sure you have the correct version of FreePBX

For this tutorial to work, you should have FreePBX Distro 5.211.65 installed, which comes with Asterisk 1.8 or Asterisk 11, and FreePBX 2.11.

To check your current FreePBX version, run the following command:

cat /etc/schmooze/pbx-version

If the above command does not work, this means you have an older version of FreePBX, and you can not use this tutorial to upgrade to the latest FreePBX version. In that case you will need to upgrade gradually from your version to the next until you reach the latest version FreePBX 13.

If the command above did not work, and you want to check your current version of FreePBX, you can use the old command below:

cat /etc/asterisk/freepbxdistro-version

Step Two — Running the FreePBX 12 upgrade script

Once you know that you have the correct version of FreePBX, you can proceed with the update process and run the upgrade script.

We will download and run the official FreePBX 2.11 to FreePBX 12 upgrade script using the commands below:

cd /usr/src/
wget http://upgrades.freepbxdistro.org/stable/6.12.65/upgrade-5.211.65-to-6.12.65-20.sh
chmod +x upgrade-5.211.65-to-6.12.65-20.sh

This will initiate the automatic FreePBX 12 update process. It can take a while to complete, but once it's done, you will need to reboot your server using the command below:


Step Three — Security warning: unsigned modules

After rebooting your server, access your FreePBX 12 admin panel and log in. You should notice the slight change in the panel design.

Usually, after upgrading, you should find the following error on the dashboard:

Security Issue: You have 'N' unsigned modules This is a critical issue and should be resolved urgently

When you click on the error message for details, you should get a list of modules that need to be signed.

To fix this, start by running the following commands:

amportal chown
amportal a ma refreshsignatures
amportal a reload

Refresh the FreePBX system status page, and check if the error is gone. If not, you will need to uninstall and reinstall each listed module manually. This can be done using the FreePBX module admin.

If you don't need one of the listed modules, you can just "Remove" it. If you require this module and want to use it, you will need uninstall the module, and then install it again.

Step Four — Upgrading to Asterisk 13

Now you will upgrade your current version of Asterisk to the latest stable version Asterisk 13.

To upgrade to Asterisk 13 you will need to switch your used version of Asterisk using the command below:


You should get the following output:

    Pick the Asterisk Version you would like to change to.
        Press 1 and the Enter key for Asterisk 1.8
        Press 2 and the Enter key for Asterisk 11
        Press 3 and the Enter key for Asterisk 12
        Press 4 and the Enter key for Asterisk 13
        Press 9 and the Enter key to exit and not change your Asterisk Version

You should press for to switch to Asterisk 13. After that, the installation and set up will start to take place automatically. This step might take some time.

After it completes, you can run the following command to confirm that Asterisk 13 is working properly:

asterisk -rvvvvv

Step Five — Installing UCP module: User Control Panel

Your old version of FreePBX came with the recordings panel module for users to access their voicemail and update their extension settings etc...

FreePBX introduced a new User Control Panel (UCP) which has many additional features and a noticeably improved user interface which makes it easier for the users.

To remove the old user panel run the commands below:

amportal a ma delete fw_ari
amportal a reload

Now, you can either use the module admin to install the new FreePBX 12 User Control Panel (UCP), or you can run the following commands:

amportal a ma download ucp
amportal a ma install ucp

You should be able to access the new FreePBX User Control Panel by navigating to the address below:



You should now have a fully working system with Asterisk 13 and FreePBX 12, the most up to date versions as of November 2014. You can also find a ready-to-use image with FreePBX 12 and Asterisk 13 when trying to create a Voiplet from your account. To create an account and start using your first Voiplet, you can sign up below.

Try this tutorial on a Cloud VoIP Server.

Includes 512MB RAM, 20GB SSD Disk, and Unlimited Transfer for $20/mo! Learn more