Enterprise Deployment Guide

About This Guide


IT Leaders, System Administrators, and/or Project Managers


Some features described in this guide are only available to Enterprise Edition E10 and/or E20. We will highlight specific licenses needed whenever applicable.

Learning Objectives

This guide provides foundational information necessary when developing a plan for a proof of concept and/or production-level enterprise deployment of Mattermost.

It will not dive into the technical implementation, but will reference any relevant documentation.

By the end of this guide you should have an understanding of the high-level requirements for a successful Mattermost Enterprise deployment.

This includes:

  • Choosing how to deploy the Mattermost Server application.
  • Migrating from other ChatOps platforms.
  • Integrating Mattermost with existing Single sign-on (SSO) providers.
  • First steps/best practices for onboarding users.


If at any point you need additional help, we are ready to assist, just reach out using any of these methods:

  • Community - Our entire organization uses Mattermost, plus you’ll have the support of one of the best open source communities around.
  • Documentation - We link to many parts of our Administrator documentation in this guide but encourage you to take a look at all our documentation.
  • Enterprise Support - If you are an Enterprise Edition subscriber, you may open a support ticket in the Enterprise Edition Support portal.

Before You Begin Your Deployment

What Makes Mattermost Different?

Mattermost is a high-trust messaging platform for enterprise use. As enterprises come in all shapes and sizes, Mattermost has been built to provide an optimal experience for all customers.

The emergence of ChatOps means Mattermost is no longer a tool predominantly used by developers. In fact, it has the ability to enhance communication for many kinds of teams through a multitude of integrations, extensions, and customization.

Here is a sample of the types of integrations our customers are deploying:

  • Confluence
  • Docker
  • GitHub/GitLab
  • Jira
  • Outlook
  • Trello

Taking this further, because Mattermost is an open source application, it can be customized, in many ways, to suit your organizational needs.

Further Reading

Mattermost Scaling

Growing your Mattermost installation from supporting a team to supporting an enterprise requires two types of scaling.

Technical Scaling: Whether used for teams or enterprises, the Mattermost server is designed to support tens of thousands of users on a single server with appropriate hardware. We officially support running Mattermost Server on multiple Linux distributions and on-premises cloud solutions.

Functional Scaling: Scaling from a team to an enterprise is like going from a “virtual office” to a “virtual campus”. Advanced features like enterprise authentication, granular permissions, compliance and auditing, and advanced reporting become increasingly important as organizations grow beyond teams.

Mattermost Licensing

Mattermost Enterprise Edition comes with two licensing options: Enterprise E10 and Enterprise E20.

The E10 license suits smaller organizations with less need for automation and compliance, while the E20 license offers features like AD/LDAP, SAML 2.0, automated compliance export, and team-specific permissions. You can find a full comparison here.

Once you have installed and deployed Mattermost, activate your Enterprise E20 trial license via Main Menu > System Console > Edition and License and select Start trial.


You can purchase and manage your Mattermost Enterprise subscriptions with our Customer Portal or reach out to our Sales team by contacting sales@mattermost.com.

Client Usage

Depending on your environment and your users, you have several options when deploying Mattermost: web browser, desktop, mobile, or all three. We provide binaries for MS Windows, macOS, Linux, iOS, and Android. However, depending on your organization policies deployment on these platforms can vary.

Deployment First Steps

Deploying Mattermost with an enterprise environment is not a small project. Depending on your use case multiple physical machines have to be set up with Mattermost server, a proxy, and a database while thousands of users need to be imported through AD/LDAP. While we strive to make this as easy as possible it will take time and iteration.

Determine Your Use Case

As mentioned above it is essential for a successful deployment to know your specific use case. To get started try answering the following questions:

  • How many users will use Mattermost on initial deployment and is this number going to increase dramatically in the near future?
  • What clients will be in use?
  • Are you migrating from an existing ChatOps or different communications platform?
  • Are you using an identity provider for Single sign-on and if yes which one?
  • What compliance requirements do you need to meet?
  • What are your organization’s security requirements?

Planning Your Deployment

Technical Requirements

The hardware requirements for the Mattermost server and database grow based on the number of users.

Depending on which clients your users will work with additional reading can be necessary: - You are going to use the web app - no further reading required. - You are going to use the desktop app - please also read Desktop Application Install Guides. - You are going to use the mobile app - please also read Mobile App Deployment Guide.


When migrating from an existing solution it is important to plan ahead. We recommend starting with a small dataset - limited users and content - to reduce the time spent debugging and ensuring all fields are imported correctly, before taking on a major import.

We provide our customers with easy to use migration solutions for many scenarios:


If your data in the bespoke messenger is not vital we recommend a hard switch after a period of running both systems in parallel.

Single Sign-On

Mattermost can act as a SAML 2.0 provider so setting up Single sign-on is a straightforward matter.

We support these SSO services:


When you have to meet compliance requirements - especially when working with proxies - make sure to plan ahead to avoid infrastructure redesign while deploying Mattermost. Here is how Mattermost supports your compliance needs:

  • Outbound Proxy - In some scenarios, like monitoring outbound traffic or controlling which websites can appear in link previews, you may wish to use Mattermost behind a proxy.
  • Electronic Discovery - Electronic Discovery (eDiscovery) is the process of searching electronic data to be used as evidence in a legal case. We have put together the eDiscovery documentation to help.
  • Compliance Export - This feature enables Compliance Exports to be produced from the System Console, containing all messages.
  • Data Retention - By default, Mattermost provides unlimited search history storing all messages without an expiration date. These defaults can be changed by setting Message Retention and File Retention to a specific duration in the System Console.
  • Custom Terms of Service - If your organization requires the use of custom ToS, this can be done in the System Console.


Security is a major concern with regard to selecting the right tools. Mattermost software is continually reviewed for security by developers, IT administrators, and security researchers. In contrast to SaaS solutions Mattermost can be deployed on-premises in your private cloud giving you full control of not only the software but the hardware side as well. Here is a non-exhaustive list of our security features:

User Onboarding and Adoption

Integrations and Plugins

On the first look considering integrations and plugins as part of the deployment might seem counterintuitive. But they are essential parts of the adoption process, empowering your organization to better understand the tools used by each department.

When choosing integrations and plugins for your deployment, focus on those bringing value to the organization. For example, if your organization is mostly working remotely the Zoom plugin might be essential, whereas a single office organization might not need it but heavily relies on Outlook integration.


Notifications have gained importance in our daily lives. Modern operating systems all have a way to point the user’s attention towards important events from specific apps. There are three different types of notifications in Mattermost: desktop, email, and mobile push notifications. Mattermost will notify you of messages with any of these characteristics:

  • Direct Messages.
  • Your username or first name is mentioned in a channel.
  • A channel you’re in is notified with @channel, @here, or @all.
  • Any of your configured keywords are used.


All notification behavior can be controlled globally or individually by channel. Desktop, email, and mobile push notifications have separate settings.

Report a Problem
Edit on GitHub