Skip to content

Installation

There are multiple ways in which you can get MongooseIM:

Alternatively, check out our tutorial on How to build MongooseIM from source code for an introduction to compiling, building and testing MongooseIM.

Packages

Go to the downloads section of the Erlang Solutions website, and choose the version of MongooseIM you want. The following sections describe the installation process for different operating systems.

Once the deb file is downloaded, open a terminal window and navigate to the directory containing the package. Use the following command to unpack and install MongooseIM:

1
sudo dpkg -i mongooseim_[version here].deb

An ODBC (RDBMS) driver must be installed on your machine to unpack and install from RPM packages. Enter the following command in a terminal window to install the latest unixODBC driver:

1
sudo yum install unixODBC

Once the RPM file is downloaded, open a terminal window and navigate to the directory containing the package. Use the following command to unpack and install MongooseIM:

1
sudo rpm -i mongooseim_[version here].rpm

Docker

In order to install MongooseIM using Docker, simply run the following command:

1
docker pull erlangsolutions/mongooseim

This will download the latest release. You can use tags to download an exact version.

We build Docker images for every release marked with a git tag, as well as for every Pull Request. You can see all of them on DockerHub. In order to learn more about how the images are built, please visit the source code repository.

The mongooseimctl command is available in /usr/lib/mongooseim/bin/mongooseimctl in the container.

Helm

You can easily install MongooseIM to a Kubernetes cluster with the help of our Helm chart, defined in the source code repository. After you have a Kubernetes cluster set up, simply run:

1
helm repo add mongoose https://esl.github.io/MongooseHelm/

to add our chart repository, and then:

1
helm install my-mongooseim mongoose/mongooseim

to install the chart. You can use any name instead of my-mongooseim, or generate a random name.

Source

Please see the tutorial How to build MongooseIM from source code.