Installation¶

There are multiple ways in which you can get MongooseIM:

install MongooseIM binaries from a package Erlang Solutions delivers,
get the Docker image,
use the Helm chart.

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 page and select the package compatible with your system version. The following sections describe the installation process for different operating systems.

Ubuntu and DebianCentOS compatible: AlmaLinux / Rocky Linux

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:

sudo dpkg -i mongooseim_[version here].deb

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:

sudo rpm -i mongooseim_[version here].rpm

Info

Packages for older systems (Ubuntu Focal, Debian Bullseye, Debian Buster, AlmaLinux 8, Rocky Linux 8) include a bundled OpenSSL 3.x, as this version is required for MongooseIM to function correctly, but is not available in the official repositories for these distributions. If your system already has OpenSSL 3.x installed, the package will detect and use the system version instead of the bundled one.

Docker¶

In order to install MongooseIM using Docker, please follow the instructions on our Docker. Once you've logged in to our Docker repository, you can simply run:

1	`docker run docker.trymongoose.im/mongooseim`

This will start the latest release of MongooseIM. If you need a specific version, you can use image tags to pull an exact release. We build Docker images for every tagged release, as well as for every Pull Request.

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.

Once you’ve set up your Kubernetes cluster and added the MongooseIM repository (as described in the link above), simply run:

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.