How to Install FusionPBX on macOS

FusionPBX is an open-source VoIP PBX system that supports a wide range of communication protocols. It can be a useful tool for businesses and individuals who want to streamlining their communication processes. In this tutorial, we’ll walk you through the process of installing FusionPBX on macOS.

Prerequisites

To complete this tutorial, you will need:

  • A macOS machine
  • A terminal emulator such as iTerm
  • Homebrew package manager installed on your macOS machine
  • PostgreSQL database installed on your macOS machine
  • FreeSWITCH installed on your macOS machine

Installation

Step 1: Install Dependencies

  1. First, ensure you have Homebrew installed by running the following command in your terminal:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

  2. Next, install the following dependencies using Homebrew:

    brew install ffmpeg git lua nginx node opus sox sqlite wget

Step 2: Install FreeSWITCH and PostgreSQL

  1. Follow the instructions provided in the FreeSWITCH and PostgreSQL installation tutorials to install these dependencies on your macOS machine.

  2. Once you have both of these dependencies installed, you can proceed to install FusionPBX.

Step 3: Install FusionPBX

  1. First, clone the FusionPBX repository from GitHub by running the following command in your terminal:

    git clone https://github.com/fusionpbx/fusionpbx.git /usr/local/www/fusionpbx

  2. Change the ownership of the FusionPBX directory to the Nginx user running on your machine, which can be either www or www-data. Use the following command to do so:

    chown -R www:www /usr/local/www/fusionpbx

  3. Next, navigate to the FusionPBX directory:

    cd /usr/local/www/fusionpbx

  4. Run the installation script:

    ./install.sh

    This script will prompt you to enter your PostgreSQL username, password, and hostname. If you followed our prerequisites and have PostgreSQL installed on your local machine, the default values for these fields should work:

    • Enter postgres as the PostgreSQL username
    • Enter your PostgreSQL password
    • Enter localhost as the PostgreSQL hostname

    The script will also prompt you to enter the Web address and port that FusionPBX will be accessible from. The default values should work, but you can modify them as necessary.

  5. Once the script completes running, you can start the Nginx web server and FusionPBX by running the following command:

    service nginx start

  6. You can now access FusionPBX by navigating to http://localhost:8080/fusionpbx in your web browser.

Congratulations! You have successfully installed FusionPBX on your macOS machine. You can now proceed to configure the system to meet your communication needs.