Supported tags
master
,master-alpine
,master-alpine.debug
latest
,latest-alpine
,latest-alpine.debug
5.4
,5.4-alpine
,5.4-alpine.debug
5.3
,5.3-alpine
,5.3-alpine.debug
5.2
,5.2-alpine
,5.2-alpine.debug
5.1
,5.1-alpine
,5.1-alpine.debug
5.4.3
,5.4.3-alpine
,5.4.3-alpine.debug
5.4.2
,5.4.2-alpine
,5.4.2-alpine.debug
5.4.1
,5.4.1-alpine
,5.4.1-alpine.debug
5.4.0
,5.4.0-alpine
,5.4.0-alpine.debug
5.3.8
,5.3.8-alpine
,5.3.8-alpine.debug
5.3.7
,5.3.7-alpine
,5.3.7-alpine.debug
5.3.6
,5.3.6-alpine
,5.3.6-alpine.debug
5.3.5
,5.3.5-alpine
,5.3.5-alpine.debug
5.3.4
,5.3.4-alpine
,5.3.4-alpine.debug
5.3.3
,5.3.3-alpine
,5.3.3-alpine.debug
5.3.2
,5.3.2-alpine
,5.3.2-alpine.debug
5.3.1
,5.3.1-alpine
,5.3.1-alpine.debug
5.3.0
,5.3.0-alpine
,5.3.0-alpine.debug
5.2.8
,5.2.8-alpine
,5.2.8-alpine.debug
5.2.7
,5.2.7-alpine
,5.2.7-alpine.debug
5.2.6
,5.2.6-alpine
,5.2.6-alpine.debug
5.2.5
,5.2.5-alpine
,5.2.5-alpine.debug
5.2.4
,5.2.4-alpine
,5.2.4-alpine.debug
5.2.3
,5.2.3-alpine
,5.2.3-alpine.debug
5.2.2
,5.2.2-alpine
,5.2.2-alpine.debug
5.2.1
,5.2.1-alpine
,5.2.1-alpine.debug
5.2.0
,5.2.0-alpine
,5.2.0-alpine.debug
5.1.10
,5.1.10-alpine
,5.1.10-alpine.debug
5.1.9
,5.1.9-alpine
,5.1.9-alpine.debug
5.1.8
,5.1.8-alpine
,5.1.8-alpine.debug
5.1.7
,5.1.7-alpine
,5.1.7-alpine.debug
5.1.6
,5.1.6-alpine
,5.1.6-alpine.debug
5.1.5
,5.1.5-alpine
,5.1.5-alpine.debug
5.1.4
,5.1.4-alpine
,5.1.4-alpine.debug
5.1.3
,5.1.3-alpine
,5.1.3-alpine.debug
5.1.2
,5.1.2-alpine
,5.1.2-alpine.debug
5.1.1
,5.1.1-alpine
,5.1.1-alpine.debug
5.1.0
,5.1.0-alpine
,5.1.0-alpine.debug
Tags master
, latest
, 5.2
and 5.1
based on alpine image with removed all libs except libc, busybox, tcpdump, dumpcap, gawk, kamailio and dependent libs.
Tags that contains -alpine
keyword based on alpine image. All OS tools is untouched and possible to use apk
utility.
Tags that contains -alpine.debug
keyword based on alpine image and includes gdb
utility with kamailio debug files.
All images designed to run on host, bridge and swarm networks.
Quick reference
-
Where to get help:
the Kamailio maillist -
Where to file issues: Kamailio bug tracker
What is Kamailio?
Kamailio is an Open Source SIP Server released under GPL, able to handle thousands of call setups per second. Kamailio can be used to build large platforms for VoIP and realtime communications – presence, WebRTC, Instant messaging and other applications.
Image usage
Before first run need to prepare kamailio default config files. If you already have kamailio config files, then you can skip this. To prepare default config files need to execute
docker create --name kamailio kamailio/kamailio-ci
docker cp kamailio:/etc/kamailio /etc
docker rm kamailio
Then you can start docker image
docker run --net=host --name kamailio \
-v /etc/kamailio:/etc/kamailio \
kamailio/kamailio-ci -m 64 -M 8
systemd unit file
You can use this systemd unit file on your docker host.
Unit file can be placed to /etc/systemd/system/kamailio-docker.service
and enabled by commands
systemd start kamailio-docker.service
systemd enable kamailio-docker.service
If you use debug
image, then need map host directory (or volume) to contianer /var/lib/coredump
folder. This may be done using additinal docker run
option -v /var/lib/coredump:/var/lib/coredump
host network
[Unit]
Description=kamailio 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 kamailio; \
docker run -t --rm=true --log-driver=none --name kamailio \
--net=host \
-v /etc/kamailio:/etc/kamailio \
kamailio/kamailio-ci'
ExecStop=/usr/bin/docker stop kamailio
[Install]
WantedBy=multi-user.target
default bridge network
[Unit]
Description=kamailio 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 kamailio; \
docker run -t --rm=true --log-driver=none --name kamailio \
--network bridge \
-p 5060:5060/udp -p 5060:5060 -p 5061:5061 \
--hostname kamailio \
-v /etc/kamailio:/etc/kamailio \
kamailio/kamailio-ci'
ExecStop=/usr/bin/docker stop kamailio
[Install]
WantedBy=multi-user.target
user defined bridge and swarm networks
Requred to create user defined network first.
docker network create --driver bridge --subnet 10.0.0.0/24 my-net
Or you can create swarm network
docker network create --driver overlay --attachable --subnet 10.0.0.0/24 my-net
Then you can create systemd unit file
[Unit]
Description=kamailio 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 kamailio; \
docker run -t --rm=true --log-driver=none --name kamailio \
--network my-net \
--ip 10.0.0.2 \
-p 5060:5060/udp -p 5060:5060 -p 5061:5061 \
--hostname kamailio.my-net \
-v /etc/kamailio:/etc/kamailio \
kamailio/kamailio-ci'
ExecStop=/usr/bin/docker stop kamailio
[Install]
WantedBy=multi-user.target
.bashrc file
To simplify kamailio managment you can add alias for kamctl
to .bashrc
file as example bellow.
alias kamctl='docker exec -i -t kamailio /usr/sbin/kamctl'