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.
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.
=== "Ubuntu and Debian"
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:
```bash
sudo dpkg -i mongooseim_[version here].deb
```
=== "CentOS compatible: AlmaLinux / Rocky Linux"
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:
```bash
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:
```bash
sudo rpm -i mongooseim_[version here].rpm
```
In order to install MongooseIM using Docker, simply run the following command:
docker pull erlangsolutions/mongooseimThis 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.
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:
helm repo add mongoose https://esl.github.io/MongooseHelm/to add our chart repository, and then:
helm install my-mongooseim mongoose/mongooseimto install the chart.
You can use any name instead of my-mongooseim, or generate a random name.
Please see the tutorial How to build MongooseIM from source code.