How to build and run MongooseIM docker image¶

The instruction below will guide you through the process of building and running the MongooseIM docker image.

Requirements¶

To follow this guide you need to have docker installed and the MongooseIM GitHub repository cloned locally.

Building docker image¶

To build a MongooseIM image, navigate to the main repo directory (referenced as $REPO in this guide) and execute:

1	`./tools/build-docker-from-remote.sh`

which will build a MongooseIM docker image based on the current local commit if it is available on the remote.

Alternatively, it is possible to build a docker image based on any commit available on remote (commit hash referenced as $COMMIT_HASH), by executing:

1	`./tools/build-docker-from-remote.sh $COMMIT_HASH`

Check the image information:

1	`docker inspect docker.io/library/mongooseim`

You can also push "docker.io/library/mongooseim" to some registry.

Running docker image¶

Full tutorial on running a docker image is available on mongooseim-docker GitHub. Here only simple and one-node configuration will be presented. In order to run it execute:

docker run -dt -h first-node --name first-node -e JOIN_CLUSTER=false mongooseim

which starts a single MongooseIM node named first-node.