Scaling for Enterprise

Mattermost is designed to scale from small teams hosted on a single server to large enterprises running in cluster-based, highly available deployment configurations.

  • Server requirements vary based on usage and it is highly recommended that pilots are run before enterprise-wide deployments in order to estimate full scale usage based on your specific organizational needs.

Single Machine Deployment

Organizations less than 500 users can typically run on a single server.

Multi-machine Deployment

Deployments between 500 and 20,000 registered users with moderate usage can run on a standard three-machine Mattermost deployment with a proxy, an application server and a database server. At this scale, demands of larger organizations can typically be met by using powerful hardware in a standard configuration.

Cluster-based Deployment

Available in Enterprise Edition E20

Deployments over 10,000 to 20,000 registered users with moderate usage can be supported by adding additional servers in cluster-based, high availability configuration. This configuration uses a load balancer to distribute requests from users across multiple Mattermost application servers, allowing the system to scale beyond the limits of any single server.

Sample Scaling Guide

This guide demonstrates how to budget for and build large-scale Mattermost deployments.

Mattermost can be deployed on-premises or on the cloud platform of your choice, including AWS, Google Cloud, Microsoft Azure and Oracle Cloud. This guide uses AWS as an example.

Based on the hardware requirements, here’s what Mattermost’s server architecture looks like for a 10,000-user deployment:


Sizing Guide Using AWS

On AWS, we recommend using the following EC2 server types as a baseline:

  • App servers: m5.xlarge
  • Database servers: r4.xlarge

For the purposes of this guide, we will assume medium usage (10 MB/user/month with a 2x safety factor) for storage estimates and 200 MB/user/month for data transfer estimates. We will also assume on-demand pricing with no upfront payments, though more savings (typically 40% or more) can be achieved with reserved servers on 1–3 year commitments and upfront payments.

As deployments scale above 5,000 users, additional servers are added for performance load-balancing and to provide additional redundancy (see our High Availability Cluster guide).

This spreadsheet shows how much hardware you’ll need for different-sized Mattermost deployments and provides an estimate of how much each will cost. It includes links to AWS’s cost calculator for various deployment sizes. The smaller deployment examples (i.e., 1,000 users and 5,000 users) are on the conservative side, with separate servers per function that can easily be scaled out as Mattermost is rolled out.

Here’s an example of the hardware you’ll need for a 10,000-user deployment:


For more information, check out our Administrator’s Guide.