OpenSIPS Docker Image

May 26, 2026 · View on GitHub

Docker recipe for building and starting an OpenSIPS image

Building the image

You can build the docker image by running:

make build

This command will build a docker image with OpenSIPS master version taken from the git repository. To build a different git version, you can run:

OPENSIPS_VERSION=3.6 make build

To build with MySQL support:

OPENSIPS_EXTRA_MODULES=opensips-mysql-module make build

To start the image, simply run:

make start

You can set different variables to tune your deployment:

DEBIAN_RELEASE - sets the base image Debian release (Default: bullseye)
OPENSIPS_VERSION - sets the opensips version (Default: 3.6)
OPENSIPS_VERSION_MINOR - forces a specific minor version of opensips (Default: not used, latest will be installed)
OPENSIPS_VERSION_REVISION - forces a specific revision/build of opensips; only taken into consideration if OPENSIPS_VERSION_MINOR is provided (Default: 1)
OPENSIPS_BUILD - specifies the build to use, nightly or releases (Default: releases)
OPENSIPS_DOCKER_TAG - indicates the docker tag (Default: latest)
OPENSIPS_CLI - specifies whether to install opensips-cli (true) or not (false) (Default: true)
OPENSIPS_EXTRA_MODULES - specifies extra opensips modules to install (Default: no other module)
OPENSIPS_COMPONENT - specifies the opensips apt component to install (Default: ${OPENSIPS_VERSION}-$ {OPENSIPS_BUILD})

Released docker packages are visible on DockerHub https://hub.docker.com/r/opensips/opensips