Skip to content


You can easily run the framasoft/mobilizon docker image standalone, but since Mobilizon requires PostgreSQL and nginx, we recommend using docker-compose.


We currently produce images for the linux/amd64 architecture (which you'll probably use it most cases), as well as for the linux/arm (ARMv7) and linux/arm64 (aarch64, ARMv8) architectures.

The docker-compose provides an app container for Mobilizon itself and a database container for PostgreSQL (Postgis). You'll need your own reverse-proxy to handle TLS termination (on port 4000).

Get the docker-compose repo

git clone docker-mobilizon
cd docker-mobilizon

Update the env file

cp env.template .env

Edit the .env content with your own settings. More settings can be added in .env, see all in docker-compose.yml file.


gpg --gen-random --armor 1 50

Advanced configuration

You can setup advanced configuration through the config.exs Elixir file. To get a file, docker cp mobilizon:/etc/mobilizon/config.exs .

It defaults to using the environment variables from .env but you may edit the existing parts and add any configuration setting you want.

To activate using the config.exs file, you may uncomment the corresponding volume line into docker-compose.yml, then simply restart the mobilizon container.

Run the service

Start both the database and the Mobilizon service. The Mobilizon service will wait for the database one.

docker-compose up -d

The eventual migrations will be automatically run before starting Mobilizon.

Run a mobilizon_ctl command

Any task documented in CLI tasks can be executed on Docker as well, but it need to be adapted, as the mix tool is not available in releases which are used in Docker images. Instead, we provide the mobilizon_ctl wrapper tool that can call any Mobilizon mix task (namedspaced under mobilizon.).

docker-compose exec mobilizon mobilizon_ctl [options]

For instance, creating a new admin without Docker would be something like:

MIX_ENV=prod mix "" --admin --password "Y0urP4ssw0rd"

Inside Docker, it would be something like:

docker-compose exec mobilizon mobilizon_ctl "" --admin --password "Y0urP4ssw0rd"

Update the service

Pull the latest image, then update the service. The migrations are automatically performed:

docker-compose pull framasoft/mobilizon
docker-compose up -d

Last update: November 23, 2021