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

About FreePBX Distro and AsteriskNOW-6.12.65 Stable Releases

Below is an outline of this version:

  • FreePBX 12
  • SHMZ OS 6.5 (Derived from CentOS)
  • Asterisk 11 or 13
  • DAHDI 2.10

System Impact

The upgrade procedures outlined below will stop Asterisk and may also require a system reboot to fully apply. Perform the system upgrade using a scheduled maintenance window.

Release Notes

Click here to view the Release Notes for 6.12.65. This page contains release notes for all of the versions listed below.

Upgrade Scripts

Upgrade Scripts

Below is a list of shell upgrade scripts officially released to update an existing FreePBX Distro 6.12.65 system to a specific minor release version. The scripts will update the entire distribution, including all FreePBX web components and all OS-level components (such as the kernel and kernel modules).

All upgrades need to be installed in numeric ascending order. Do not skip any available upgrade step. Upgrade scripts are not cumulative. Each upgrade script should be run in ascending order to get to the desired final version.

The upgrade path is one-way. These scripts cannot be used to downgrade the version of FreePBX Distro to an earlier version. The only way to reverse the effects of the upgrade procedure is to restore the system from a backup.

How to Check the Current FreePBX Distro Version

You can check your current FreePBX Distro version by going to the Web GUI sysadmin module. Or, from the Linux command line, do a:

cat /etc/asterisk/freepbxdistro-version

on older systems and

cat /etc/schmooze/pbx-version

on newer systems

Upgrade Option 1: Manual Upgrade Using Version Upgrade Scripts


1.) Check the current FreePBX Distro version. Display the current version file (as above) to confirm the current installed version of FreePBX Distro.



2.) Download and run the applicable upgrade script. To install an update script via the Linux command line, use the following commands, substituting the proper scripts from above. Download the upgrade script matching the current version of FreePBX Distro installed, mark it as executable, and run it.


cd ~
mkdir upgradescripts
cd upgradescripts

chmod +x

The FreePBX Distro upgrade script will update both FreePBX components (Asterisk, the FreePBX web GUI) and all base CentOS components.

Note any special instructions displayed at the end of the upgrade if any are displayed, such as to reboot the system.

3.) Confirm the new FreePBX Distro version. Cat the updated (now current) version file (as above) to confirm the current installed version of FreePBX Distro is the expected newer version.

Upgrade Option 2: Upgrade Using Commercial System Administration Pro Module

If you have the sysadmin module installed and have also purchased the SysAdmin Pro commercial license, you can use either the FreePBX web GUI to perform an update or run the following script from the command line. This will automatically update your system to the latest version.


Command line


Resolving OS Configuration File Changes

Some upgrade scripts will result in .rpm package updates that need configuration files to be manually cleaned up afterwards. The general procedure is described in the page Cleaning up files from a RPM update.

Specific Update Notes

    • Delete the default package fail2ban configuration file. FreePBX Distro generates a customized version of this file.

      rm /etc/fail2ban/jail.local.rpmnew
    • MySQL activity logging to /var/log/mysql/mysql.log is disabled in this release. This MySQL log file can be quite large, depending on server usage loads. Delete this file after the update to reclaim this disk space.

      rm /var/log/mysql/mysql.log
    • Replace the old version of /etc/dahdi/modules with the updated version of the file

      mv /etc/dahdi/modules.rpmnew /etc/dahdi/modules
    • The upgrade to 10.13.66 requires the ability for the MySQL root user to login to the database without a password. This is the default case. This can be tested by running "mysql" as the OS root user and see if the login happens without any password prompt. If you have set a password for the MySQL root user, create a /root/.my.cnf to supply the password so MySQL can be accessed without a password prompt. Ensure this file is only readable by the root user as it will have the password in plain text. Do this before running the upgrade script.

      # set the file to be read/write for root only
      chmod 600 /root/.my.cnf
    • Consider switching to Asterisk ver. 13 with asterisk-version-switch. Asterisk ver. 13 is the recommended version to use, and some features (such as presence state) are not supported on Asterisk 11.
    • After completing the upgrade to 10.13.66-1, continue with applying subsequent updates to the 10.13.66 track at FreePBX-Distro-10.13.66 to get fully current
    • Disable and then uninstall and remove obsolete modules such as "FreePBX ARI Framework" (the old user web GUI) and "FreePBX FOP Framework" (the old Flash Operator Panel). Uninstalling the "FreePBX ARI Framework" is needed as the uninstall creates a Web forward from the HTTP .../recordings URL to send users to the new .../ucp (User Control Panel) URL.
    • Log into the new FreePBX 13 web GUI and address any warnings or notifications in the web GUI

CentOS is a Trademark of Red Hat and we do not claim to have any relationship with either Red Hat or CentOS


Asterisk and AsteriskNOW are registered trademarks of Digium Inc.


  • No labels

1 Comment

  1. In upgrade option 1, step 2, it says "Download the upgrade script matching the current version of FreePBX Distro installed", but you actually want to download the script matching the next version, correct? If I'm on 6.12.65-29, I need to download 6.12.65-30, not -29. The wording could be improved.