{"id":7655,"date":"2024-06-04T21:17:50","date_gmt":"2024-06-05T04:17:50","guid":{"rendered":"https:\/\/ioflood.com\/blog\/?p=7655"},"modified":"2024-06-04T21:17:50","modified_gmt":"2024-06-05T04:17:50","slug":"install-freeswitch-linux","status":"publish","type":"post","link":"https:\/\/ioflood.com\/blog\/install-freeswitch-linux\/","title":{"rendered":"FreeSWITCH Installation on Linux | For Debian \/ Centos"},"content":{"rendered":"
\n
\"Depiction<\/figure>\n<\/div>\n

While working to configure VoIP telephony solutions on Linux servers at IOFLOOD<\/a>, we spent time installing Freeswitch. From our experience, Freeswitch’s support for various telephony protocols make it a preferred choice for building scalable communication platforms. Through today’s article, we aim to equip our customers with the knowledge and tools needed to create reliable communication solutions on their own dedicated cloud hosting<\/a> services.<\/p>\n

In this guide, we will walk you through the process of installing Freeswitch on Linux.<\/strong> We will cover methods for both APT (Debian and Ubuntu) and YUM-based distributions (CentOS and AlmaLinux), delve into compiling Freeswitch<\/code> from source, installing a specific version, and finally, how to use the Freeswitch<\/code> command and ensure it’s installed correctly.<\/p>\n

So, let’s dive in and begin installing Freeswitch<\/code> on your Linux system!<\/p>\n

TL;DR: How Do I Install Freeswitch on Linux?<\/h2>\n

\n You can install Freeswitch on Linux by first updating your package lists with the command sudo apt-get update<\/code>. After that, you can install Freeswitch using the command sudo apt-get install freeswitch<\/code>.\n<\/p><\/blockquote>\n

sudo apt-get update\nsudo apt-get install freeswitch\n\n# Output:\n# Reading package lists... Done\n# Building dependency tree\n# Reading state information... Done\n# The following additional packages will be installed:\n#   freeswitch-meta-all\n# Suggested packages:\n#   freeswitch-sounds-en-us-callie-32000 freeswitch-sounds-en-us-callie-48000\n# The following NEW packages will be installed:\n#   freeswitch freeswitch-meta-all\n# 0 upgraded, 2 newly installed, 0 to remove and 0 not upgraded.\n# Need to get 0 B\/22.5 kB of archives.\n# After this operation, 81.9 kB of additional disk space will be used.\n# Do you want to continue? [Y\/n]\n<\/code><\/pre>\n
This is a basic way to install Freeswitch on Linux, but there’s much more to learn about installing and using Freeswitch. Continue reading for more detailed information and advanced usage scenarios.<\/p>\n
Getting Started with Freeswitch<\/h2>\n
Freeswitch<\/code> is a scalable open-source cross-platform telephony platform designed to route and interconnect popular communication protocols using audio, video, text, or any other form of media. It was created in 2006 to fill the void left by proprietary commercial solutions. Freeswitch<\/code> also provides a stable telephony platform on which many telephony applications can be developed using a wide range of free tools.<\/p>\n
Let’s get started with installing Freeswitch<\/code> on your Linux device. We will cover the installation process using two popular package managers: apt<\/code> and yum<\/code>.<\/p>\n
Installing Freeswitch with APT<\/h3>\n
apt<\/code> is the package manager used by Debian and Ubuntu. To install Freeswitch<\/code> using apt<\/code>, you’ll need to open a terminal and type the following commands:<\/p>\n
sudo apt-get update\nsudo apt-get install -y freeswitch\n\n# Output:\n# Reading package lists... Done\n# Building dependency tree\n# Reading state information... Done\n# The following additional packages will be installed:\n#   freeswitch-meta-all\n# Suggested packages:\n#   freeswitch-sounds-en-us-callie-32000 freeswitch-sounds-en-us-callie-48000\n# The following NEW packages will be installed:\n#   freeswitch freeswitch-meta-all\n# 0 upgraded, 2 newly installed, 0 to remove and 0 not upgraded.\n# Need to get 0 B\/22.5 kB of archives.\n# After this operation, 81.9 kB of additional disk space will be used.\n# Do you want to continue? [Y\/n]\n<\/code><\/pre>\n
The first command updates your package lists, ensuring you have the latest version of the packages. The second command installs Freeswitch<\/code>.<\/p>\n
Installing Freeswitch with YUM<\/h3>\n
yum<\/code> is the default package manager for CentOS, Fedora, and RHEL. To install Freeswitch<\/code> using yum<\/code>, open a terminal and type the following commands:<\/p>\n
sudo yum update -y\nsudo yum install -y freeswitch\n\n# Output:\n# Loaded plugins: fastestmirror, langpacks\n# Loading mirror speeds from cached hostfile\n#  * base: mirror.its.dal.ca\n#  * extras: mirror.its.dal.ca\n#  * updates: mirror.its.dal.ca\n# Resolving Dependencies\n# --> Running transaction check\n# ---> Package freeswitch.x86_64 0:1.10.3-1.el7 will be installed\n# --> Finished Dependency Resolution\n# Installed:\n#   freeswitch.x86_64 0:1.10.3-1.el7\n<\/code><\/pre>\n
The first command updates your package lists, and the second command installs Freeswitch<\/code>. Now, you have Freeswitch<\/code> installed on your Linux system and ready for use.<\/p>\n
Installing Freeswitch from Source<\/h2>\n
Installing from source code allows you to customize your installation, apply patches, and sometimes get the latest features before they’re available in package managers.<\/p>\n
To install Freeswitch<\/code> from source, you’ll need to clone the Freeswitch<\/code> GitHub repository and compile it. Here’s how:<\/p>\n
# Install dependencies\nsudo apt-get install -y git autoconf automake libtool g++\n\n# Clone the Freeswitch repository\ngit clone https:\/\/github.com\/signalwire\/freeswitch.git\n\ncd freeswitch\n\n# Build and install\n.\/bootstrap.sh -j\n.\/configure\nmake\nsudo make install\n<\/code><\/pre>\n
This script first installs the necessary dependencies. It then clones the Freeswitch<\/code> repository, builds the source code, and installs Freeswitch<\/code>.<\/p>\n
Install Specific Freeswitch Versions<\/h2>\n
Different versions of Freeswitch<\/code> can have different features, bug fixes, and compatibility with other software. It’s important to choose a version that suits your needs.<\/p>\n
Installing Specific Versions from Source<\/h3>\n
To install a specific version of Freeswitch<\/code> from source, you’ll need to checkout the specific version after cloning the repository:<\/p>\n
git clone https:\/\/github.com\/signalwire\/freeswitch.git\ncd freeswitch\n\ngit checkout v1.10.2\n\n# Build and install\n.\/bootstrap.sh -j\n.\/configure\nmake\nsudo make install\n<\/code><\/pre>\n
Installing Specific Versions with APT<\/h3>\n
To install a specific version of Freeswitch<\/code> with apt<\/code>, you’ll need to specify the version number when installing:<\/p>\n
sudo apt-get install freeswitch=1.10.2~release~12~bbe59a6a1d~buster\n<\/code><\/pre>\n
Installing Specific Versions with YUM<\/h3>\n
To install a specific version of Freeswitch<\/code> with yum<\/code>, you’ll need to enable the freeswitch-release<\/code> repository and specify the version number when installing:<\/p>\n
sudo yum install freeswitch-1.10.2\n<\/code><\/pre>\n
Version Comparisons<\/h3>\n\n\n\n\n\n\n\n
Version<\/th>\nKey Changes<\/th>\nCompatibility<\/th>\n<\/tr>\n<\/thead>\n
1.10.2<\/td>\nBug fixes, new features<\/td>\nCompatible with most systems<\/td>\n<\/tr>\n
1.10.1<\/td>\nPerformance improvements<\/td>\nOlder systems may not be compatible<\/td>\n<\/tr>\n
1.10.0<\/td>\nInitial release<\/td>\nCompatible with all systems<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
Using and Verifying Freeswitch<\/h2>\n
After installing Freeswitch<\/code>, you can verify its installation and get familiar with some basic usage.<\/p>\n
Verifying the Installation<\/h3>\n
You can verify the installation of Freeswitch<\/code> by checking its version:<\/p>\n
freeswitch -version\n\n# Output:\n# FreeSWITCH Version 1.10.2~64bit ( 64bit)\n<\/code><\/pre>\n
Basic Usage of Freeswitch<\/h3>\n
Freeswitch<\/code> has many commands and options. Here’s an example of how to start Freeswitch<\/code> in the foreground with console logs:<\/p>\n
freeswitch -ncwait\n\n# Output:\n# FreeSWITCH Version 1.10.2~64bit is ready\n# 2019-11-05 17:15:30.639287 [NOTICE] switch_event.c:453 Subclass reservation deleted for presence_state::dialog\n<\/code><\/pre>\n
This command starts Freeswitch<\/code> in the foreground and waits for the system to be ready. The -ncwait<\/code> option tells Freeswitch<\/code> not to fork and run in the background, and to output logs to the console.<\/p>\n
Alternate Freeswitch Install Methods<\/h2>\n
While we have covered the basic and intermediate methods of installing Freeswitch<\/code> on Linux, there are alternative methods that offer different advantages. These methods are particularly useful for those who want to experiment with different setups or require a specific configuration for their use case.<\/p>\n
Freeswitch Installation Using Docker<\/h3>\n
Docker is a platform that allows you to automate the deployment, scaling, and management of applications within containers. Installing Freeswitch<\/code> using Docker can simplify the setup process and make it easier to manage and scale your Freeswitch<\/code> instances.<\/p>\n
Here’s how you can get Freeswitch<\/code> up and running using Docker:<\/p>\n
# Pull the Freeswitch Docker image\nsudo docker pull bettervoice\/freeswitch-container:latest\n\n# Run the Freeswitch container\nsudo docker run -d --name=freeswitch bettervoice\/freeswitch-container:latest\n<\/code><\/pre>\n
The first command pulls the latest Freeswitch<\/code> Docker image from Docker Hub. The second command runs the Freeswitch<\/code> container in detached mode, which means it runs in the background.<\/p>\n
Manual Installation of Freeswitch<\/h3>\n
Manual installation gives you the most control over the installation process, allowing you to customize Freeswitch<\/code> to your exact requirements. However, it is also the most complex method and requires a good understanding of Linux system administration.<\/p>\n
Here’s a brief overview of how you might manually install Freeswitch<\/code>:<\/p>\n
# Download the Freeswitch source code\nwget https:\/\/files.freeswitch.org\/freeswitch-releases\/freeswitch-1.10.2.tar.gz\n\n# Extract the source code\ntar -xvf freeswitch-1.10.2.tar.gz\ncd freeswitch-1.10.2\n\n# Compile and install the source code\n.\/configure && make && sudo make install\n<\/code><\/pre>\n
This script downloads the Freeswitch<\/code> source code, extracts it, and then compiles and installs Freeswitch<\/code>.<\/p>\n
Comparing the Methods<\/h3>\n\n\n\n\n\n\n\n
Method<\/th>\nAdvantages<\/th>\nDisadvantages<\/th>\n<\/tr>\n<\/thead>\n
APT\/YUM<\/td>\nSimple, quick<\/td>\nLimited customization<\/td>\n<\/tr>\n
Docker<\/td>\nEasy management, scalability<\/td>\nRequires Docker knowledge<\/td>\n<\/tr>\n
Manual<\/td>\nFull control, customization<\/td>\nComplex, time-consuming<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
While each method has its advantages and disadvantages, the best method for you depends on your specific requirements and level of expertise. For beginners, using apt<\/code> or yum<\/code> is recommended. For those who need scalability and easy management, Docker is a great choice. And for those who need full control and customization, manual installation is the way to go.<\/p>\n
Installation Issue Tips: Freeswitch<\/h2>\n
While installing Freeswitch<\/code> on Linux is generally straightforward, you might encounter some issues. Here are common problems and their solutions.<\/p>\n
Issue: Package Not Found<\/h3>\n
This issue occurs when the Freeswitch<\/code> package is not available in your package manager’s repositories.<\/p>\n
sudo apt-get install freeswitch\n\n# Output:\n# Reading package lists... Done\n# Building dependency tree\n# Reading state information... Done\n# E: Unable to locate package freeswitch\n<\/code><\/pre>\n
Solution:<\/strong> Make sure your package lists are up to date. You can update them with sudo apt-get update<\/code> for apt<\/code> or sudo yum update<\/code> for yum<\/code>. If the issue persists, check if Freeswitch<\/code> is available in your distribution’s repositories.<\/p>\n
Issue: Freeswitch Service Not Starting<\/h3>\n
This problem occurs when Freeswitch<\/code> does not start after installation.<\/p>\n
sudo service freeswitch start\n\n# Output:\n# Failed to start freeswitch.service: Unit freeswitch.service not found.\n<\/code><\/pre>\n
Solution:<\/strong> Check if Freeswitch<\/code> is installed correctly by checking its version with freeswitch -version<\/code>. If it’s not installed, follow the installation steps again. If the issue persists, check the system logs for any errors.<\/p>\n
Issue: Freeswitch Command Not Found<\/h3>\n
This issue occurs when the Freeswitch<\/code> command is not found, which means it’s not installed or not in your PATH<\/code>.<\/p>\n
freeswitch -version\n\n# Output:\n# Command 'freeswitch' not found, but can be installed with...\n<\/code><\/pre>\n
Solution:<\/strong> Make sure Freeswitch<\/code> is installed by following the installation steps. If it’s installed but the command is not found, add Freeswitch<\/code> to your PATH<\/code>.<\/p>\n
Remember, while these solutions cover common issues, they might not solve every problem. If you’re facing a unique issue, consider seeking help from the Freeswitch<\/code> community or professional support.<\/p>\n
Telephony & Communication Explored<\/h2>\n
Before diving deeper into the functionalities of Freeswitch<\/code>, it’s essential to understand the basics of telephony platforms and communication protocols.<\/p>\n
Telephony Platforms<\/h3>\n
In the digital world, a telephony platform is a system that manages the routing and switching of voice, fax, and other forms of data from one point to another. It’s the backbone of any communication network, allowing multiple devices to communicate seamlessly.<\/p>\n
Freeswitch<\/code> is one such telephony platform. It’s a software switchboard that connects and directs calls from one line to another, over a network, based on certain protocols.<\/p>\n
# Sample Freeswitch command to show active calls\nfreeswitch@localhost> show calls\n\n# Output:\n# uuid  direction  created                   created_epoch  name  state\n# ==================================================================================================\n# 9d61b8f8-067f-1239-12fa-005056b204e2  inbound   2021-05-17 10:32:22  1621264342  sofia\/internal\/1001@localhost.com  CS_EXECUTE\n<\/code><\/pre>\n
This command lists all active calls on your Freeswitch<\/code> server. In the output, you can see the unique identifier for each call, the direction of the call, and the current state of the call.<\/p>\n
Communication Protocols<\/h3>\n
Communication protocols define the rules for data exchange over a network. They determine the format, timing, sequencing, and error checking of messages. Some common protocols that Freeswitch<\/code> supports include SIP (Session Initiation Protocol), XMPP (Extensible Messaging and Presence Protocol), and WebRTC (Web Real-Time Communication).<\/p>\n
For instance, SIP is a signaling protocol used for initiating, maintaining, modifying, and terminating real-time sessions that include voice, video, and messaging applications.<\/p>\n
# Sample Freeswitch command to show SIP registrations\nfreeswitch@localhost> sofia status profile internal reg\n\n# Output:\n# Call-ID      User    Contact\n# ==================================================================================================\n# MThkYzUxNz  1001    \"1001\" <sip:1001@192.168.1.2:5060>\n<\/code><\/pre>\n
This command shows all SIP registrations on your Freeswitch<\/code> server. In the output, you can see the call ID, the user, and the contact information for each registration.<\/p>\n
Understanding these fundamentals is crucial as they form the basis of how Freeswitch<\/code> operates. With a solid foundation, you can better appreciate the power and flexibility Freeswitch<\/code> offers in handling telephony tasks.<\/p>\n
The Relevance of Freeswitch<\/h2>\n
Freeswitch<\/code> isn’t just a tool for handling telephony tasks; it’s a versatile solution that plays a crucial role in system administration and communication. Its capabilities extend beyond basic call routing, offering functionalities like IVR, conferencing, and even text-to-speech conversion.<\/p>\n
Exploring Related Concepts: VoIP and SIP<\/h3>\n
Understanding Freeswitch<\/code> also opens the door to broader concepts in the world of digital communication. Two such concepts are VoIP (Voice over Internet Protocol) and SIP.<\/p>\n
VoIP is a technology that allows voice calls to be made over an internet connection instead of a regular phone line. Freeswitch<\/code> can be used as a VoIP server, managing and routing VoIP calls within a network.<\/p>\n
SIP, on the other hand, is a protocol used to control communication sessions. It’s one of the protocols Freeswitch<\/code> supports and is commonly used for managing multimedia communication sessions such as voice and video calls.<\/p>\n
# Sample Freeswitch command to show SIP registrations\nfreeswitch@localhost> sofia status profile internal reg\n\n# Output:\n# Call-ID      User    Contact\n# ==================================================================================================\n# MThkYzUxNz  1001    \"1001\" <sip:1001@192.168.1.2:5060>\n<\/code><\/pre>\n
This command shows all SIP registrations on your Freeswitch<\/code> server. In the output, you can see the call ID, the user, and the contact information for each registration.<\/p>\n
Further Resources for Mastering Freeswitch<\/h3>\n
To delve deeper into the world of Freeswitch<\/code>, here are some resources that provide more detailed information:<\/p>\n