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 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 | |
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 | |
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 | |
Docker¶
In order to install MongooseIM using Docker, simply run the following command:
1 | |
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 | |
to add our chart repository, and then:
1 | |
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.