Docker image for FreeSWITCH. With handpicked modules and minimal configurations, this image is not very useful on its own, as it is meant to be the base image for other FreeSWITCH-based containers.
Clone this repository and build an image locally:
$ docker build -t ericyan/freeswitch .
$ docker run -d --net=host --cap-add SYS_NICE --name <contaner_name> ericyan/freeswitch
We are using --net=host here, as mapping a large port range can eat a lot of
memory (Docker issue #11185).
The --cap-add SYS_NICE is necessary to allow FreeSWITCH to adjust scheduling
priority (issue #5).
You may override ports by setting environment variables with one or more -e
flags. For example, adding flag -e "INTERNAL_SIP_PORT=9060" will change the
SIP port of internal profile. Refer to Dockerfile for other options.
To access the FreeSWITCH CLI:
$ docker exec -it <container_name> fs_cli -P <event_socket_port>
If you have changed the event socket port, then you must specify the new port
number using the -P flag.
This image comes with a limited set of preinstalled modules:
- mod_commands
- mod_event-socket
- mod_sofia
- mod_dialplan-xml
- mod_dptools
This image is designed to be deployed on a private network. By default, clients on LAN are able to make calls without authentication. So if you are planning to put it on a public-facing network, do make sure that appropriate hardening is in place.
See also: https://freeswitch.org/confluence/display/FREESWITCH/Security