Deployment Guide#

Welcome to deployment guidance for Mattermost. This guide is organized into sections based on application types and deployment scenarios to help you achieve a successful deployment of Mattermost across various platforms.

Whether you’re deploying the server application, desktop application, or mobile application, or troubleshooting deployments, this guide has you covered. Use the navigation below to access detailed information about each topic.

  • Application architecture - An overview of Mattermost’s architecture and components.

  • Server deployment - Pre-deployment checks, security considerations, hardware recommendations, software prerequisites, and step-by-step guidance to deploying Mattermost server.

  • Desktop deployment - Installation procedures for Mattermost’s desktop applications across Windows, macOS, and Linux, and large-scale, enterprise-wide deployments.

  • Mobile deployment - How to set up push notifications using Mattermost’s notification service and troubleshooting tips.

  • Deployment troubleshooting - Best practices for diagnosing and resolving common deployment issues.

How to use this guide#

Navigate through the sections using the headings above to find the deployment instructions and troubleshooting steps pertinent to your needs. Each section is designed to provide clear, actionable information to ensure a successful deployment and operation of Mattermost.

If you are new to Mattermost, we recommend starting with the Preparations section under Server Application to understand the prerequisites and get started.

Note

  • Mattermost server deployment is officially supported on Linux operating systems only.

  • macOS and Windows deployments are supported for testing and development purposes only.

  • If you encounter issues that aren’t covered in this documentation:

Enjoy deploying Mattermost with confidence!