FreeSWITCH Dockerfile

This project can be used to deploy a FreeSWITCH server inside a Docker container. The container currently uses the latest stable release version 1.6.x. An effort was made to build many modules so the container can be generic enough to serve many purposes.

The container now includes fail2ban but in order for fail2ban to update the rules in IPTables it must be run with the --privileged flag.

The container exposes the following ports:

5060/tcp 5060/udp 5080/tcp 5080/udp as SIP Signaling ports.
5066/tcp 7443/tcp as WebSocket Signaling ports.
8021/tcp as Event Socket port.
64535-65535/udp as media ports.

Running the Container

CID=$(sudo docker run --name freeswitch -p 5060:5060/tcp -p 5060:5060/udp -p 5080:5080/tcp -p 5080:5080/udp -p 8021:8021/tcp -p 7443:7443/tcp -p 60535-65535:60535-65535/udp -v /home/ubuntu/freeswitch/conf:/usr/local/freeswitch/conf bettervoice/freeswitch-container:1.6.6)

Keep in mind that freeswitch has to be able to read the mounted volume.

Large port range issue

Because of an issue in docker, mapping a large port range like in -p 60535-65535:60535-65535/udp can eat a lot of memory. Starting docker with --userland-proxy=false solves this partially, but startup will still be slow. As a workaround you can remove this from the docker commandline and manually add the iptables rules instead:

CIP=$(sudo docker inspect --format='{{.NetworkSettings.IPAddress}}' $CID)

sudo iptables -A DOCKER -t nat -p udp -m udp ! -i docker0 --dport 60535:65535 -j DNAT --to-destination $CIP:60535-65535
sudo iptables -A DOCKER -p udp -m udp -d $CIP/32 ! -i docker0 -o docker0 --dport 60535:65535 -j ACCEPT
sudo iptables -A POSTROUTING -t nat -p udp -m udp -s $CIP/32 -d $CIP/32 --dport 60535:65535 -j MASQUERADE

Systemd configuration

Follow the following steps in order to run start this docker instance via systemctl.

Customizations For customizing the startup settings look at the wiki documentation in GitHub which deals with running docker as a service in systemd.

sudo cp sysv/systemd/docker.freeswitch.service /lib/systemd/system/
sudo systemctl daemon-reload
sudo cp sysv/docker.freeswitch.py /usr/local/bin/

# Enable the service
sudo systemctl enable docker.freeswitch
# Start the service
sudo systemctl start docker.freeswitch
# Stop the service
sudo systemctl stop docker.freeswitch

Configuration

Make sure you properly set rtp-start-port and rtp-end-port in autoload_configs/switch.conf.xml. Also you need to set ext-rtp-ip and ext-sip-ip for every profile which is accessible from your public ip address. See the freeswitch documentation for further instructions.

Shell access

sudo docker exec -it freeswitch /bin/bash

Available Modules

The following modules are available in the container and can be loaded at runtime by providing a modules.conf.xml file with the desired module names uncommented.

Applications

mod_avmd: Detects voicemail beeps using a generalized approach.
mod_blacklist: Blacklist module.
mod_callcenter: Call queuing application that can be used for call center needs.
mod_cidlookup: Provides a means (database, url) to lookup the callerid name from a number.
mod_commands: A mass plethora of API interface commands.
mod_conference: Conference room module.
mod_curl: Allows scripts to make HTTP requests as receive responses as plain text or JSON.
mod_db: Database key/value store functionality, group dialing, and limit backend.
mod_directory: Dial by Name directory.
mod_distributor: Simple round-robin style distributions.
mod_dptools: Dialplan Tools: provides a number of apps and utilities for the dialplan.
mod_easyroute: A simple DID routing engine that uses a database lookup to determine how to route an incoming call.
mod_enum: Route PSTN numbers over internet according to ENUM servers, such as e164.org
mod_esf: Holds the multi cast paging application for SIP.
mod_esl: Allows to generate remote ESL commands.
mod_expr: Brian Allen Vanderburg's expression evaluation library.
mod_fifo: FIFO module.
mod_fsk: FSK (Frequency-Shift Keying) data transfer
mod_fsv: FreeSWITCH Video application (Recording and playback)
mod_hash: Hashtable key/value store functionality and limit backend
mod_httapi: HT-TAPI Hypertext Telephony API (Twilio FreeSWITCH style)
mod_http_cache: HTTP GET with caching.
mod_ladspa: use Auto-tune on your call.
mod_lcr: Implements LCR (Least Cost Routing)
mod_memcache: API that integrates with memcached (a distributed key/value object store)
mod_mongo: http://www.mongodb.org/
mod_mp4: MP4 File Format support for video apps.
mod_nibblebill: Billing module ("nibbles" at credit/cash amounts during calls)
mod_oreka: Module for Media Recording with Oreka
mod_rad_auth: use RADIUS for authentication
mod_redis: supplies a limit back-end that uses Redis.
mod_rss: Reads RSS feeds via a TTS engine.
mod_sms: Apps for chat messages
mod_snapshot: Records a sliding window of audio and can take snapshots to disk.
mod_snom: Controlling softkeys on Snom phones (button function, led state, label etc.)
mod_spandsp: Spandsp tone and DTMF detectors. A combination of mod_fax and mod_voipcodecs and mod_t38gateway.
mod_spy: User spy module.
mod_stress: Module for detecting voice stress.
mod_tone_detect: Tone detection module.
mod_translate: Format numbers into a specified format.
mod_valet_parking: Allows calls to be parked and picked up easily.
mod_vmd: Voicemail beep detection module.
mod_voicemail: Full-featured voicemail module.
mod_voicemail_ivr: VoiceMail IVR Interface.
mod_xml_odbc: Allows user directory to be accessed from a database in realtime.

Speech Recognition / Text-to-Speech

mod_flite - Free open source Text to Speech.
mod_pocketsphinx - Free open source Speech Recognition.
mod_tts_commandline - Run a command line and play the outputted file.
mod_unimrcp - Module for an open MRCP implementation

Codecs

mod_amr: GSM-AMR (Adaptive Multi-Rate) codec.
mod_amrwb: GSM-AMRWB (ARM Wide Band) codec.
mod_bv: BroadVoice16 and BroadVoice32 audio codecs (Broadcom codecs).
mod_celt: CELT ultra-low delay audio codec.
mod_codec2: FreeSWITCH CODEC2 Module.
mod_dahdi_codec - DAHDI Codecs (G729A 8.0kbit, G723.1 5.3kbit).
mod_g723_1: G.723.1 codec.
mod_g729: G.729 codec.
mod_h26x: H26X signed linear codec.
mod_ilbc: ILBC codec.
mod_isac: Internet Speech Audio Codec open sourced by Google, used in WebRTC
mod_mp4v: MPEG4 video codec
mod_opus: The OPUS ultra-low delay audio codec (http://opus-codec.org/)
mod_siren: G.722.1 (Siren7) and G.722.1 Annex C (Siren14) Polycom codecs.
mod_speex: Speex codec.
mod_theora: Theora video codec
mod_voipcodecs: VoIP Codecs (G.711, G.722, G.726, GSM-FR, IMA_ADPCM, LPC10)
mod_vp8: VP8 video codec

Dialplan

mod_dialplan_asterisk: Allows you to create dialplans the old-fashioned way.
mod_dialplan_directory: Allows you to obtain a dialplan from a directory resource
mod_dialplan_xml: Allows you to program dialplans in XML format.
mod_yaml: Allows you to program dialplans in YAML format.

Directories

mod_ldap: LDAP module made to obtain dialplans, user accounts, etc.

Endpoints

mod_alsa: Sound card endpoint.
mod_dingaling: Jabber/Google Talk integration module; note XMPP access to Google Voice ended 2014.05.15
mod_loopback: Loopback endpoint module - A loopback channel driver to make an outbound call as an inbound call.
mod_portaudio: Voice through a local soundcard.
mod_rtmp: "Real time media protocol" endpoint for FreeSWITCH.
mod_skinny: SCCP module
mod_skypopen: Skype compatible module.
mod_sofia: SIP module.

Event Handlers

mod_cdr_csv: CSV call detail record handler.
mod_cdr_mongodb: MongoDB CDR module
mod_cdr_pg_csv: Asterisk Compatible CDR Module with PostgreSQL interface
mod_cdr_sqlite: SQLite CDR Module
mod_erlang_event: Module to send/receive events/commands in Erlang's binary format.
mod_event_multicast: Broadcasts events to netmask.
mod_event_socket: Sends events via a single socket.
mod_event_zmq: http://www.zeromq.org/
mod_json_cdr: JSON CDR Module to files or curl
mod_radius_cdr: RADIUS CDR Module.
mod_rayo: 3PCC over XMPP - http://rayo.org/xep
mod_snmp: SNMP AgentX module
mod_xml_cdr - XML-based call detail record handler.

File Formats

mod_local_stream: Multiple channels connected to same looped file stream.
mod_native_file: File interface for codec specific file formats.
mod_portaudio_stream: Stream from an external audio source for Music on Hold
mod_shell_stream: Stream audio from an arbitrary shell command. Read audio from a database, from a soundcard, etc.
mod_shout: MP3 files and shoutcast streams.
mod_sndfile: Multi-format file format transcoder (WAV, etc)
mod_ssml: Speech Synthesis Markup Language parser
mod_tone_stream: Tone Generation Stream.
mod_vlc: Stream audio from VLC media player using libvlc.

Languages

mod_lua - Lua support.
mod_perl - Perl support.
mod_python - Python Support.
mod_v8 - Google V8 JavaScript (ECMAScript) engine.

Loggers

mod_console - Console logger.
mod_logfile - File logger.
mod_syslog - Syslog logger.

Language-Specific

mod_say_de - German language text-to-speech engine
mod_say_en - English language text-to-speech engine
mod_say_es - Spanish language text-to-speech engine
mod_say_fa - Persian language text-to-speech engine
mod_say_fr - French language text-to-speech engine
mod_say_he - Hebrew language text-to-speech engine
mod_say_hr - Croatian language text-to-speech engine
mod_say_hu - Hungarian language text-to-speech engine
mod_say_it - Italian language text-to-speech engine
mod_say_ja - Japanese language text-to-speech engine
mod_say_nl - Dutch language text-to-speech engine
mod_say_pl - Polish language text-to-speech engine
mod_say_pt - Portuguese language text-to-speech engine
mod_say_ru - Russian language text-to-speech engine
mod_say_th - Thai language text-to-speech engine
mod_say_zh - Chinese, Mandarin, Cantonese language text-to-speech engine

External API's

mod_xml_curl - XML Gateway Code. Configure FreeSWITCH™ from a web server on boot and on the fly.
mod_xml_ldap - LDAP XML Gateway.
mod_xml_radius - RADIUS authentication gateway.
mod_xml_rpc - XML Remote Procedure Calls. Issue commands from your web application.
mod_xml_scgi - Simple Common Gateway Interface.

tvandergeer/freeswitch-container