/
Recorder installation v 1.10.10
Document toolboxDocument toolbox

Recorder installation v 1.10.10

Owned by ef.confluence
Last updated: Mar 21, 2025
4 min read

Pre Conditions:

Before installing Recorder you must run these commands.

#sudo apt update #sudo apt install -y gnupg2 wget lsb-release [Optional] #sudo

Navigate to "/etc/apt/sources.list"

Comment out this line [ deb cdrom:[Debian GNU/Linux 12.2.0 Bookworm - Official amd64 DVD Binary-1 with firmware 20231007-10:29]/ bookworm main non-free-firmware ] with #.

Also make sure that the repositories listed in the "/etc/apt/sources.list" are for the latest release of Debain. (Currently 12.2 'Bookworm')
Below are the dependencies for Debain Bookworm. If you have a different version please add accordingly.

#deb http://deb.debian.org/debian/ bookworm main #deb-src http://deb.debian.org/debian/ bookworm main #deb http://deb.debian.org/debian/ bookworm-updates main #deb-src http://deb.debian.org/debian/ bookworm-updates main

If you make any changes to the "sources.list" file.  Make sure to run the update command again.

Update your system

#sudo apt-get update

Go into super user mode to get rid of permission issues.

#su

For the latest version of Debian such as Book worm we need to follow the following steps as well.

Before we install the recorder, we need to clone the Sofia-sip and SpandDSP in /usr/src directory. In case git is not installed please install the git by running the 'apt install git' command.

#git clone https://github.com/freeswitch/sofia-sip #git clone https://github.com/freeswitch/spandsp

Now add all these dependencies. Some of these dependencies may not be available in the future or the latest versions will be available. Please exclude it from the command and add the latest one.

#sudo apt-get -y install build-essential subversion automake autoconf wget libtool libtool-bin libncurses5-dev libssl-dev libsndfile1-dev #sudo apt-get install git libcurl4-openssl-dev libexpat1-dev libssl-dev libtiff5-dev libx11-dev unixodbc-dev python3-dev zlib1g-dev libasound2-dev libogg-dev libvorbis-dev libperl-dev libgdbm-dev libdb-dev python3-dev uuid-dev bison autoconf g++ libncurses-dev

Run the following commands one by one to install Sofia Sip:

cd /usr/src/sofia-sip #./bootstrap.sh #./configure #sudo make && sudo make install

Run the following commands one by one to install Spandsp:

#cd /usr/src/spandsp #git reset --hard 67d2455efe02e7ff0d897f3fd5636fed4d54549e #./bootstrap.sh #./configure #sudo make && sudo make install

Go to the signal wire website and login and then make a token.. If you already have a token please proceed.

Now, run the following commands one by one to add repositories to your apt directory

In case you do not have TOKEN for recorder click here to get token for your recorder.

#$TOKEN=pat_8Errev5k19bRCnmsGdJSxGEs [In case you don't have your token please get one from signalwire website] #wget --http-user=signalwire --http-password=$TOKEN -O /usr/share/keyrings/signalwire-freeswitch-repo.gpg https://freeswitch.signalwire.com/repo/deb/debian-release/signalwire-freeswitch-repo.gpg #echo "machine freeswitch.signalwire.com login signalwire password $TOKEN" > /etc/apt/auth.conf #chmod 600 /etc/apt/auth.conf #echo "deb [signed-by=/usr/share/keyrings/signalwire-freeswitch-repo.gpg] https://freeswitch.signalwire.com/repo/deb/debian-release/ `lsb_release -sc` main" > /etc/apt/sources.list.d/freeswitch.list #echo "deb-src [signed-by=/usr/share/keyrings/signalwire-freeswitch-repo.gpg] https://freeswitch.signalwire.com/repo/deb/debian-release/ `lsb_release -sc` main" >> /etc/apt/sources.list.d/freeswitch.list

Note that "#" is the indicator of a new command. Do not copy and run all commands at the same time.

After these commands run the update command and the install command.

#sudo apt update #apt-get build-dep freeswitch

Then get the source. Use the -b flag to get a specific branch for specified version v1.10.10

#cd /usr/src/ #git clone https://github.com/signalwire/freeswitch.git -b v1.10.10 freeswitch #cd freeswitch

 

Because we're in a branch that will go through many rebases, it’s better to set this one, or you'll get CONFLICTS when pulling (update).

#git config pull.rebase true #./bootstrap.sh -j #./configure #make #make install

 

Edit the Recorder System Service

#sudo nano /etc/systemd/system/freeswitch.service

 

Replace the previous content with this version (omitting User and Group):

[Unit] Description=FreeSWITCH After=network.target [Service] Type=forking PIDFile=/usr/local/freeswitch/run/freeswitch.pid ExecStart=/usr/local/freeswitch/bin/freeswitch -u root -g root -ncwait -nonat ExecStop=/usr/local/freeswitch/bin/freeswitch -stop Restart=always LimitCORE=infinity LimitNOFILE=100000 LimitNPROC=60000 LimitSTACK=250000 TimeoutSec=300 [Install] WantedBy=multi-user.target

Now Reload System and Enable Recorder

#sudo systemctl daemon-reload #sudo systemctl enable freeswitch

Now start Recorder

#sudo systemctl start freeswitch

Now Verify Recorder Status

#sudo systemctl status freeswitch

Add to path

#export PATH=$PATH:/usr/src/freeswitch

Also add in the path in the bash or zsh file .

Open the file in an editor:

  • If you're using bash (most common):

    #nano ~/.bashrc

  • If you're using zsh:

    #nano ~/.zshrc

Add this line at the end of the file:

#export PATH=$PATH:/usr/src/freeswitch

Save the file (In nano, press CTRL + X, then Y, then ENTER).

Apply the changes by running:

#source ~/.bashrc # or source ~/.zshrc if using zsh

Now run fs_cli and you Recorder CLI will be opened 

 Recorder has been installed proceed further to configure it.

Restart recorder once configuration is completed

# systemctl restart freeswitch

In case of any problem, complete documentation can be found here. 

 

 

 

 

If Recorder was already installed and you want to reinstall it follow this guide

To completely uninstall recorder from a Debian 12 server, you can follow these steps. This will remove both the recorder application and its configuration files:

  1. Stop recorder

First, stop the Recorder service if it's running:

#sudo systemctl stop freeswitch

 

  1. Uninstall Recorder Packages

Use apt to remove the recorder packages. This will uninstall recorder but leave the configuration files:

sudo apt remove --purge freeswitch*

The --purge flag ensures that configuration files are also removed.

 

  1. Remove Dependencies

After uninstalling recorder, you can remove any unneeded dependencies:

sudo apt autoremove

 

  1. Delete Leftover Files

Check for any leftover Recorder directories or files and remove them manually:

#sudo rm -rf /usr/local/freeswitch #sudo rm -rf /etc/freeswitch #sudo rm -rf /var/lib/freeswitch #sudo rm -rf /var/log/freeswitch #sudo rm -rf /var/run/freeswitch

 

  1. Remove User and Group

If Recorder created a specific user and group, you can delete them as well:

#sudo deluser freeswitch #sudo delgroup freeswitch

 

  1. Verify Removal

You can check if FreeSWITCH has been completely removed by running:

which freeswitch

This should return no output if Recorder is uninstalled completely.

 

  1. Reboot (Optional)

If you want to ensure everything is properly cleaned up, you can reboot the server:

#sudo reboot

 

This process should completely uninstall FreeSWITCH from your Debian 12 server.

 

Related content