Deploy Mattermost

Available on all plans

self-hosted deployments

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

Deploy on Ubuntu - Signed packages direct from Mattermost featuring a single command for install and upgrades.
Deploy using Docker - The fastest way to try Mattermost and a great single server installation option.
Deploy with a tarball - Support for any Linux distribution.
Deploy using Omnibus - An entire Mattermost installation on a single server.
Deploy using Kubernetes - Install using the Mattermost Helm Chart or Operator and simplified updates.
Deploy on Red Hat - Support for all current Red Hat Enterprise Linux platforms with a tarball.

Tip

See the configuration settings documentation to learn more about customizing your production deployment.
Encountering issues with your deployment? See the Deployment Troubleshooting or high scale troubleshooting documentation for details.

Prepare for your Mattermost deployment

These guides will help you prepare for your Mattermost deployment.

Software and hardware requirements - Confirm software and hardware requirements for your Mattermost deployment.
Prepare your Mattermost database - Learn how to prepare and configure a database for Mattermost.
About the Mattermost Kubernetes Operator - Learn more about the Mattermost Kubernetes Operator.
Administrator tasks - Learn about the standard configurations and settings you’ll encounter.
Architecture overview - Learn the basics of user authentication, notifications, data management services, network connectivity, and high availability.
Plan your Mattermost implementation - Get a detailed breakdown of the technical requirements to deploy Mattermost for your team or organization.
Enterprise roll out checklist - Learn how to roll Mattermost out to thousands of users.
Welcome email template - Use our sample email template when you’re ready to invite users to your server.

These deployment guides are for administrators who are ready to integrate Mattermost with their organization’s IT infrastructure.

Deployment overview - Learn the basics of the Mattermost user experience, communication protocols, network access, data storage, and deployment options.
Set up a socket-based Mattermost database - Connect your Mattermost server to your database service.
Image proxy - Setup and configure an image proxy to make loading images faster and more reliable and prevent pixel tracking.
Backup and disaster recovery - Implement data backups, disaster recovery, and high availability deployment.
Encryption options - Setup encryption for data in transit and at rest.
Configure transport encryption - Use transport encryption between Mattermost clusters and your proxy and database.
Bleve search - Use the Bleve search engine to provide Lucene-style full-text search.

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

Desktop Apps

Desktop app install guides
Desktop app deployment guide - Customize and distribute the Mattermost desktop app with pre-configured settings.
Desktop MSI installer and group policy installation guides (beta) - Use the Mattermost MSI installer and Group Policy definitions for Windows deployment.
Desktop app custom dictionaries - Create custom dictionaries for Mattermost spellcheck.
Desktop managed resources - Configure resource management for services running on the same domain as your Mattermost instance.

Mobile Apps

Using Mattermost’s pre-built mobile apps - Connect users to your Mattermost server with our prebuilt apps for Android and iOS.
iOS setup - Install the Mattermost mobile app for iOS.
Android setup - Install the Mattermost mobile app for Android.
Testing push notifications - Learn how to test mobile push notifications.
Deploy Mattermost mobile apps - Learn the basics of how to customize and deploy Mattermost to the Enterprise.
Mobile push notifications - Set up mobile push notifications.
Building and distributing your own custom Mattermost mobile apps - Build custom mobile Mattermost apps.
Deploying mobile apps using an EMM provider - Deploy with Enterprise Mobile Management software to enforce security policies and enforce specific versions of the Mattermost mobile apps.
AppConfig for EMM solutions with Mattermost mobile apps - Learn how AppConfig provides an easy way to configure enterprise mobile applications.
Mobile VPN options - Learn how to use the Mattermost mobile apps with Mobile VPNs.
Mobile apps frequently asked questions
Client-side data storage frequently asked questions

Stay up to date with the latest features and improvements.

Prepare to upgrade Mattermost - Learn how to prepare for a Mattermost upgrade.
Upgrade Mattermost Server - Learn the basics of upgrading your Mattermost server to the latest version.
Enterprise install and upgrade - Learn how to upgrade your Mattermost server to premium versions.
Install a license key - Learn how to add or change a Mattermost license key.
Release definitions - Get details on the Mattermost release schedule and the types of releases.
Important upgrade notes - Find version-specific upgrade considerations.
Release lifecycle - See critical release lifecycle dates.
Extended Support Release - Get information about releases that have extended release support.
Downgrade Mattermost Server - Find out how to roll back to older versions of Mattermost.
Version archive - Download binaries for every release.

Scale and monitor your Mattermost deployment.

Scale for Enterprise - Scale Mattermost to tens of thousands of users and beyond.
High availability cluster - Maintain Mattermost service during outages and hardware failures with redundant infrastructure.
Elasticsearch - Enhance search performance with Elasticsearch.
Performance monitoring - Use Prometheus and Grafana to monitor the health and performance of your Mattermost cluster.
Mattermost performance alerting guide - Learn strategies and best practices for monitoring your Mattermost cluster.