forked from Mirrors/freeswitch
a972bf6dd7 | ||
---|---|---|
.. | ||
Dockerfile | ||
README.md | ||
docker-entrypoint.sh | ||
freeswitch-config.patch | ||
healthcheck.sh | ||
make_min_archive.sh | ||
sounds_version.txt |
README.md
About
This is minimized official FreeSwitch docker container. Container designed to run on host network. Size of container decreased to 120MB (54MB compressed) Significantly increased security:
- removed all libs except libc, busybox, freeswitch and dependent libs.
- removed 'system' API command from vanila config
- updated FreeSwitch default SIP password to random value
Used environment variables
SOUND_RATES
- rates of sound files that must be downloaded and installed. Available values8000
,16000
,32000
,48000
. May defined multiply values using semicolon as delimiter. ExampleSOUND_RATES=8000:16000
;SOUND_TYPES
- types of sound files that must be downloaded and installed. Available values music,en-us-callie
,en-us-allison
,ru-RU-elena
,en-ca-june
,fr-ca-june
,pt-BR-karina
,sv-se-jakob
,zh-cn-sinmei
,zh-hk-sinmei
. ExampleSOUND_TYPES=music:en-us-callie
;EPMD
- start epmd daemon, useful when you use mod_erlang and mod_kazoo FreeSwitch modules. Available valuestrue
,false
.
Usage container
- Creating volume for sound files. This may be skipped if you not use freeswitch MOH and other sound files.
docker volume create --name freeswitch-sounds
- Stating container
docker run --net=host --name freeswitch \
-e SOUND_RATES=8000:16000 \
-e SOUND_TYPES=music:en-us-callie \
-v freeswitch-sounds:/usr/share/freeswitch/sounds \
-v /etc/freeswitch/:/etc/freeswitch \
safarov/freeswitch
systemd unit file
You can use this systemd unit file on your hosts.
$ cat /etc/systemd/system/freeswitch-docker.service
[Unit]
Description=freeswitch Container
After=docker.service network-online.target
Requires=docker.service
[Service]
Restart=always
TimeoutStartSec=0
#One ExecStart/ExecStop line to prevent hitting bugs in certain systemd versions
ExecStart=/bin/sh -c 'docker rm -f freeswitch; \
docker run -t --net=host --name freeswitch \
-e SOUND_RATES=8000:16000 \
-e SOUND_TYPES=music:en-us-callie \
-v freeswitch-sounds:/usr/share/freeswitch/sounds \
-v /etc/kazoo/freeswitch/:/etc/freeswitch \
freeswitch'
ExecStop=-/bin/sh -c '/usr/bin/docker stop freeswitch; \
/usr/bin/docker rm -f freeswitch;'
[Install]
WantedBy=multi-user.target
Unit file can be placed to /etc/systemd/system/freeswitch-docker.service
and enabled by command
systemd start freeswitch-docker.service
systemd enable freeswitch-docker.service
.bashrc file
To simplify freeswitch managment you can add alias for fs_cli
to .bashrc
file as example bellow.
alias fs_cli='docker exec -i -t freeswitch /usr/bin/fs_cli'
How to create custom container
This container created from scratch image by addiding required freeswitch files packaged to tar.gz archive. To create custom container:
- install required FreeSwitch packages. Now supported debian dist
apt-get install freeswitch-conf-vanilla
- clone freeswitch repo
git clone https://freeswitch.org/stash/projects/FS/repos/freeswitch/browse
- execute
make_min_archive.sh
script
cd freeswitch/docker/base_image
./make_min_archive.sh
- build custom container
docker build -t freeswitch_custom .