FreePBX®

FreePBX® is the most popular graphical administration and end-user interface for the open-source Asterisk® telephony toolkit. Build a cloud phone system, a call center, a WebRTC application, or a custom audio service. This one-click build is ready to connect to your SIP phones and VoIP providers immediately. You can add extra functionality through free or commercial add-on modules.

FreePBX and Asterisk are corporately sponsored by Sangoma Technologies.

Software Included

Package Version License
asterisk 18 GPLv2
freepbx 16 GPLv3

Creating an App using the Control Panel

Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Deploy to DO

Creating an App using the API

In addition to creating a Droplet from the FreePBX® 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB FreePBX® Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "simontelephonics-freepbx-7-8"}' \
        "https://api.digitalocean.com/v2/droplets"

Getting Started After Deploying FreePBX®

This image boots to the FreePBX out-of-box experience.

Web

Connect to the GUI at your droplet’s IPv4 or IPv6 address. The initial form prompts you to set up your administrative login, so do this right away upon launch.

After a series of setup prompts, including language selection and the enabling of the firewall (recommended), you will be presented with the FreePBX dashboard, a simple monitor and control panel for your PBX. Basic connectivity and call routing is set up in Trunks (to your VoIP providers), Extensions (to your phones), and Inbound/Outbound Routes.

Setup instructions including a getting-started guide and manuals for each module are available at the FreePBX Wiki. Documentation on the underlying Asterisk software can be found at the Asterisk Wiki.

SSH

SSH to your droplet’s IPv4 or IPv6 address using the centos user (unprivileged, with sudo access) or root using your SSH key (preferred method). FreePBX command-line tasks can be accomplished using the fwconsole command; you can connect to the Asterisk CLI with asterisk -r once you have become root.

Enabling the commercial repo

To enable commercial module access and install the free System Administration module, from the GUI:

  • Admin -> Module Admin
  • Select Commercial and then Check Online
  • Select the System Admin module and choose Download and Install

From SSH, as root:

  • fwconsole ma enablerepo commercial
  • fwconsole ma listonline # to see a list of module options
  • fwconsole ma downloadinstall sysadmin
  • fwconsole r