Skip to main content

Linux Quick Install Guide


This page is archived for reference by confluence editors while it is revised to match the new Confluence schema.

This page must remain generic with no references to specific distributions. Please place notes for specific distributions in the proper locations!



This is a generic quick install guide for Linux and Unix.

Who This is For

Experienced Linux/Unix users familiar with FreeSWITCH™ installation or want a quick overview without reading the Installation Page.



These mandatory prerequisites provide for compiling the standard FreeSWITCH™ installation and test the supplied configuration and sample IVR. They are sufficient for many production systems.


There are optional modules that can be built and if so may require one or more of the following;


Selecting a Version

There are two versions of FreeSWITCH™ to choose from: the stable version recommended for production systems, and _master_containing the latest fixes and features used duringdevelopment. The stable version is recommended unless you have experience with FreeSWITCH™. Additional Information is located at Source Options.

This documentation is tested with the master version to keep it as recent as possible and to provide feedback to the developers. If there are problems the developers may request that you install the master version for diagnosis.

Download Using Git Clone

Download FreeSWITCH™ by switching to the src directory and invoking one of the "git clone" commands below. The git command will create the freeswitch directory in src (/usr/local/src/freeswitch) and download the FreeSWITCH™ source files.

cd /usr/local/src
git clone

Generate Installation and Configuration Files

Create Configuration Files

cd freeswitch    # <- the new freeswitch directory created by the git clone process

Edit modules.conf

This is optional but consider editing modules.conf.

Compile the Source


Install FreeSWITCH™

make all install cd-sounds-install cd-moh-install

Start FreeSWITCH™

Make sure no other instance of FreeSWITCH™ or Asterisk is running on the same computer. Run command:


Test a SIP Phone

Configure a SIP phone or softphone with the IP address of the FreeSWITCH™ computer and user "1000" and password "1234". The default FreeSWITCH™ configuration provides pre-defined definitions for extensions 1000-1019, all passwords are 1234.

  • Dial 9664 to hear music.
  • Dial 5000 to test the sample IVR
  • Configure a second SIP phone as user 1001, dial 1001 from 1000, and 1000 from 1001 to test between phones
  • Check out more in Configuring FreeSWITCH at Some stuff to try out!


  • If there is no communication between the phones and FreeSWITCH™ or between phones disable the firewall on your Linux server. If testing is successful activate the firewall and open only the specific ports needed. For more information about firewalls and ports to open, see the Firewall page.
  • If you suspect networking issues look into networking tools such as Wireshark or TCPDump.