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
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 https://framagit.org/framasoft/joinmobilizon/docker.git docker-mobilizon cd docker-mobilizon
Update the env file¶
cp env.template .env
.env content with your own settings. More settings can be added in .env, see all in docker-compose.yml file.
You can generate values for
gpg --gen-random --armor 1 50
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
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
docker-compose exec mobilizon mobilizon_ctl [options]
For instance, creating a new admin without Docker would be something like:
MIX_ENV=prod mix mobilizon.users.new "firstname.lastname@example.org" --admin --password "Y0urP4ssw0rd"
Inside Docker, it would be something like:
docker-compose exec mobilizon mobilizon_ctl users.new "email@example.com" --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