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 application - Pre-deployment checks, security considerations, hardware recommendations, software prerequisites, and step-by-step guidance to deploying Mattermost server.

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

  • Mobile application - 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 are not covered in this documentation, please consult the Mattermost community forums, or reach out to Mattermost support for assistance. For advanced customization or integrations, refer to the Open source components section for details about extending Mattermost functionality.

Enjoy deploying Mattermost with confidence!