Scroll to navigation

kamailio(8) Kamailio SIP Server kamailio(8)


kamailio - a very fast and configurable SIP server


kamailio [ -hfcmMdVIhEeblLnvKrRDTNWwtugPGSQOaAxXY ] [ -a auto-aliases-mode ] [ -A pre-processor-define ] [ -b max_rcv_buf_size ] [ -f config-file ] [ -g gid ] [ -G pgid-file ] [ -l address ] [ -L modules-dir ] [ -M private_mem_size ] [ -m shared_mem_size ] [ -n processes-no ] [ -N tcp processes-no ] [ -P pid-file ] [ -t chroot-dir ] [ -u uid ] [ -w working-dir ]


kamailio is a very fast and configurable SIP (RFC3261) server.


-a auto-aliases-mode
Enable auto-aliases with 'yes' or 'on', disable with 'no' or 'off
Add an alias, the value has to be '[proto:]hostname[:port]' (like for 'alias' global parameter)
Control atexit callbacks execution from external libraries which may access destroyed shm memory causing crash on shutdown. Can be y[es] or 1 to enable atexit callbacks, n[o] or 0 to disable, default is yes.
-A pre-processor-define
Add config pre-processor define (e.g., -A WITH_AUTH, -A N=1, -A X='"Y"')
-b max_rcv_buf_size
Maximum receive buffer size which will not be exceeded by the auto-probing procedure even if the OS allows.
Checks the config file and displays the aliases and listen interface list.
Print configuration file evaluating includes and ifdefs
Turns on debugging, multiple -d increase the debug level.
Debugging level value
Control how daemonize is done:
-D - do not fork (almost) anyway (run in foreground, doesn't fork into daemon mode);
-DD - do not daemonize creator (main process is not daemonized);
-DDD - daemonize (default)
Log messages printed in terminal colors (requires -E)
Sends all the log messages to stderr.
-f config-file
Reads the configuration from config-file (default /etc/kamailio/kamailio.cfg ).
-g gid
Changes the group id under which kamailio runs.
-G pgid-file
Creates a file containing the pgid of the main kamailio process.
-h --help
Displays a short usage description, including all available options.
Displays details of internal constants and attributes.
Turns on via host checking when forwarding replies.
-l address
Listens on the specified address/interface. Multiple -l mean listening on multiple addresses. The address format is [proto:]address[:port], where proto = udp|tcp and address = host|ip_address|interface_name. Example: -l localhost, -l udp:, -l eth0:5062. The default behaviour is to listen on all the ipv4 interfaces.
load the module specified by name
log engine name and data
-L modules-dir
Specifies the directory where to look for kamailio modules (default: /usr/lib/x86_64-linux-gnu/kamailio/modules or /usr/lib64/kamailio/modules)
-m shared_mem_size
Size of the shared memory which will be allocated (in Megabytes).
set the module parameter type has to be 's' for string value and 'i' for int value, example: --modparam=corex:alias_subdomains:s:" NAME ".org
-M private_mem_size
Size of the private memory which will be allocated per process (in Megabytes).
-n processes-no
Specifies the number of children processes forked per interface (default 8).
-N tcp processes-no
Specifies the number of children processes forked to handle tcp incoming connections (by default is equal to -n ).
-P pid-file
Creates a file containing the pid of the main kamailio process.
-O optimization-level
Script optimization level (debugging option).
-P pid-file
Creates a file containing the pid of the main kamailio process.
Number of sctp child processes (default: equal to -n ).
Uses dns to check if it is necessary to add a "received=" field to a via.
Same as -r but uses reverse dns (to use both: -rR ).
Set the value for server_id
Set a subst preprocessor directive
Set a substdef preprocessor directive
Set a substdefs preprocessor directive.
Disables SCTP support.
-t chroot-dir
Forces kamailio to chroot after reading the config file.
Disables TCP support.
-u uid
Changes the user id under which kamailio runs.
-v -V --version
Displays the version number.
-x name
Specify internal manager for shared memory (shm) can be: fm, qm or tlsf
-X name
Specify internal manager for private memory (pkg) if omitted, the one for shm is used
.BI -Y " dir"
Runtime dir path
-w working-dir
Specifies the working directory. In the very improbable event that kamailio will crash, the core file will be generated here.
-W type
poll method (depending on support in OS, it can be: poll, epoll_lt, epoll_et, sigio_rt, select, kqueue, /dev/poll).







Full documentation on kamailio, including configuration guidelines, FAQs and licensing conditions, is available at

For reporting bugs see

Mailing lists: - kamailio user community - kamailio development, new features and unstable version
03.02.2021 kamailio