Deploy Mattermost

Learn how to install, deploy, and scale Mattermost for teams and organizations of any size.

Deploy Mattermost for production use

Available in Mattermost Free and Starter subscription plans. Available for Mattermost Self-Hosted deployments.

When you’re ready to install Mattermost server for production use, you have four options: deploy using Kubernetes, deploy from a compressed tarball, deploy using a Ubuntu option called Omnibus, or deploy using Docker.

Tip

Important

Mattermost bundles the components of a Mattermost deployment into a single installation, called Omnibus. Mattermost Omnibus currently supports Ubuntu’s bionic and focal distributions. The package bundles the free, unlicensed Mattermost Enterprise version of Mattermost, and leverages the apt package manager to install and update the platform components. A custom CLI and ansible recipes link the components together and configures them.

  1. In a terminal window, run the following command to configure the repositories needed for a PostgreSQL database, configure an NGINX web server to act as a proxy, configure certbot to issue and renew the SSL certificate, and configure the Mattermost Omnibus repository so that you can run the install command.

    curl -o- https://deb.packages.mattermost.com/repo-setup.sh | sudo bash
    
  2. Install the Omnibus package.

    sudo apt install mattermost-omnibus -y
    

To issue the certificate, the installer requests a domain name and an email address from you. These are used to generate the certificate and deliver any related communications. After all the packages are installed, Omnibus runs ansible scripts that configure all the platform components and starts the server.

Note

If you encounter EXPKEYSIG, this indicates that the certificate is expired. To obtain a new certificate, run the following commands:

sudo apt-key remove 44774B28
sudo curl -o- https://deb.packages.mattermost.com/pubkey.gpg | sudo apt-key add -
sudo apt update
  1. Open a browser and navigate to your Mattermost domain either by domain name (e.g. mymattermostserver.com), or by the server’s IP address if you’re not using a domain name.

  2. Create your first Mattermost user, invite more users, and explore the Mattermost platform.

    Note

    We recommend installing and configuring Omnibus with SSL enabled; however, you can run the following command to disable SSL: sudo MMO_HTTPS=false apt install mattermost-omnibus.

Mattermost Omnibus is integrated with the apt package manager. When a new Mattermost version is released, run: sudo apt update && sudo apt upgrade to download and update your Mattermost instance.

Prepare for your Mattermost deployment

These guides will help you prepare for your Mattermost deployment.

Install guides

The Mattermost server and client apps can run on all of the most popular platforms. Here’s a list of the most popular installation methods.

Desktop and Mobile App installation

These guides will get you up and running with Mattermost desktop and mobile apps in minutes.

Deployment guide

The deployment guide is for administrators who are ready to integrate Mattermost with their organization’s IT infrastructure.

Server deployment

Desktop and Mobile App deployment

Customize the Mattermost desktop and mobile apps to meet any deployment needs.

Desktop Apps

Mobile Apps

Upgrade Mattermost

Stay up to date with the latest features and improvements.

Scale Mattermost

Scale and monitor your Mattermost deployment.