Self-Managed Administrator’s Guide

In-depth documentation on installation, deployment, and administration of Mattermost.

• Architecture Overview
  • Basics
  • High Availability and Scalability
  • Reference Architectures
• Deployment Overview
  • Requirements and Installation Guides
  • User Experience
  • Communication Protocols
  • Network Access and Multi-Factor Authentication
  • Data Center Infrastructure
  • Mattermost Server
  • Data Stores
  • Deployment Options

Getting Started

Use the following materials as a template to help you plan and document the implementation of Mattermost at your organization.

• Light Install Guide
  • Installation
  • Add Users
  • Create a Notifications Hub
• Enterprise Roll Out Checklist
  • Checklist Overview
  • Checklist Details
• Administrator Tasks
  • Getting Started Tasks
  • Important Administration Notes
  • Common Tasks
  • User Experience Optimizations
• Implementation Plan
  • 1 Introduction
  • 2 System Overview
  • 3 Management Overview
  • 4 Implementation Support
• Welcome Email to End Users
  • Email Template

Installing Mattermost

Learn how to get Mattermost running on your environment.

• Software and Hardware Requirements
• Installing on Ubuntu 20.04 LTS
• Installing on Ubuntu 18.04 LTS
• Installing Mattermost Omnibus
• Installing on Kubernetes
• Installing on Debian Buster
• Installing on RHEL 7
• Installing on RHEL 8
• Installing on CentOS, Oracle Linux, and Scientific Linux
• Instructions On Setting Up a Socket-based Mattermost Database
• Enterprise Install and Upgrade
• Configuring Transport Encryption
• Deploy Mattermost on Bitnami
• Local Machine Setup using Docker
• AWS Elastic Beanstalk Docker Setup
• Installing Mattermost Team Edition in GitLab Helm Chart
• Desktop Application Install Guides
• Desktop Managed Resources
• Desktop MSI Installer and Group Policy Installation Guides (Beta)

Deployment

Learn how to host Mattermost to meet your networking requirements.

• Deployment Overview
  • Requirements and Installation Guides
  • User Experience
  • Communication Protocols
  • Network Access and Multi-Factor Authentication
  • Data Center Infrastructure
  • Mattermost Server
  • Data Stores
  • Deployment Options
• Desktop App Deployment Guide
  • Custom Build Configuration
  • Windows App: Pre-Configuration and Silent Deployment
  • Windows App: Silently Removing the App
• AppConfig for EMM Solutions with Mattermost Mobile Apps
  • What is AppConfig?
  • Mattermost AppConfig Values
  • Other AppConfig Settings
• Image Proxy
  • Local Image Proxy
  • atmos/camo Image Proxy
• Encryption Options
  • Encryption-in-transit
  • Gossip Encryption (Experimental):
  • Encryption-at-rest
• Client-side Data Storage FAQ
  • Mobile Web Experience
  • Mobile App Experience
• Backup and Disaster Recovery
  • Backup
  • Disaster Recovery
• Bleve Search (Experimental)
  • Configuring Bleve in Mattermost
  • Using Bleve Search

Configure Mattermost

Learn how to configure settings to meet your unique requirements.

• Configuration Settings
  • Configuration in Database
  • Environment Variables
  • Override Mattermost License File
  • Load Custom Configuration Defaults
  • About
  • Reporting
  • User Management
  • Environment
  • Site Configuration
  • Authentication
  • Plugins (Beta)
  • Integrations
  • Compliance
  • Experimental
  • Settings configurable only in config.json
  • Experimental Settings only in config.json
  • Deprecated Configuration Settings
• Configuration in the Mattermost Database
  • How to Migrate Configuration to the Database
  • Troubleshooting
• Configuration Settings Prior to v5.12
  • General
  • Advanced Permissions
  • Authentication
  • Security
  • Notifications
  • Integrations
  • Plugins (Beta)
  • Files
  • Customization
  • Compliance
  • Advanced
  • Settings configurable only in config.json
  • Experimental Settings
• Customizing Mattermost
  • Mattermost Webapp
  • Mattermost Server
  • Mattermost Mobile Applications
  • Mattermost Desktop Applications
• Email Templates
  • Available templates
• Custom Branding Tools
  • Enable Custom Branding
• SMTP Email Setup
  • How to Enable Email
  • Sample SMTP Settings
  • Troubleshooting SMTP
• Configuring CloudFront to host Mattermost static assets
  • Upgrade Notes
• Using an Outbound Proxy
  • Configuration
  • Sample Configuration
• Chinese, Japanese and Korean Search
  • 日本語 / Japanese
  • 中文 / Chinese
  • 한국어 / Korean
• Configuring Apache2 (Unofficial)
  • Configuring Apache2 as a proxy for Mattermost Server (Unofficial)
  • Configuring Apache2 with SSL and HTTP/2 (Unofficial)

Incident Collaboration

• Mattermost Incident Collaboration

Mobile Apps

Learn how to configure and administer Mattermost apps.

• Mobile Applications Guide
  • Install from Apple App Store and Google Play
  • Build the apps yourself
  • Use an EMM provider with Managed App Configuration
• AppConfig for EMM Solutions with Mattermost Mobile Apps
  • What is AppConfig?
  • Mattermost AppConfig Values
  • Other AppConfig Settings
• Hosted Push Notification Service
  • Securing your Mattermost Push Notification Service
  • Setting up HPNS Push Notifications in Enterprise Edition
• Mobile Apps FAQ
  • Can I connect to multiple Mattermost servers using the mobile apps?
  • Is there a tablet version of the mobile apps?
  • Can the permanent sidebar on tablet devices be disabled?
  • How is data handled on mobile devices after a user account is deactivated?
  • Do I need to compile the mobile apps to host my own push notification server?
  • How do push notifications work?
  • What post metadata is sent in mobile push notifications?
  • How can I use ID-Only Push Notifications to protect notification content from being exposed to third-party services?
  • What are my options for securing the mobile apps?
  • What are my options for securing push notifications?
  • Why do I sometimes see a delay in receiving a push notification?
  • How do I deploy Mattermost with Enterprise Mobility Management (EMM) providers?
  • How do I host the Mattermost push notification service?
  • How do I receive mobile push notifications if my IT policy requires the use of a corporate proxy server?
  • How do I white label the app and customize build settings?
  • How do I preconfigure the server URL for my users?
  • How can I get Google SSO to work with the Mattermost mobile app?
  • How do I configure deep linking?
  • How do I connect users across internal and external networks?
• Troubleshooting Mobile Applications
  • I keep getting a message “Cannot connect to the server. Please check your server URL and internet connection.”
  • Login with ADFS/Office365 is not working
  • I see a “Connecting…” bar that does not go away
  • I’m not receiving push notifications on my device
  • All my outbound connections need to go through a proxy. How can I connect to the Mattermost Hosted Push Notification Service?
  • Build gets stuck at bundleReleaseJsAndAssets
  • No image previews available in the mobile app
  • None of these solve my problem!

Onboard Users

Learn how to get your users into and comfortable using Mattermost.

• Bulk Loading Data
  • About the bulk loading command
  • Running the bulk loading command
  • Data Format
  • Troubleshooting
• Migration Guide
  • Migrating the Mattermost Server
  • Migrating to Mattermost From Other Messaging Solutions
• Migrating from HipChat to Mattermost
  • Step 1: Set up your Mattermost Instance
  • Step 2: Export your data from HipChat Data Center or HipChat Server
  • Step 3: Import your data into Mattermost
  • Step 4: Onboard your users into Mattermost
• Migration Announcement Email
  • Email Template
• Provisioning Workflows
  • User Provisioning
  • User Deprovisioning
• Additional System Admin Roles (E20)
  • Assigning Admin Roles
  • Editing Privileges of Admin Roles (Advanced)
  • Admin Roles and Privileges
  • Frequently Asked Questions
• Active Directory/LDAP Setup
  • Overview
  • Pre-installation Notes
  • Getting Started
  • Troubleshooting/FAQ
• Multi-factor Authentication
  • Enabling MFA
  • Enforcing MFA (E10)
• AD/LDAP Groups (E20)
  • Overview
  • Pre-installation Notes
  • Enabling AD/LDAP Group Synchronization
  • Using AD/LDAP Group Synchronization
  • Linking AD/LDAP Groups to Mattermost Groups
  • Configuring the Group
  • Adding Default Teams or Channels For The Group
  • Synchronizing Teams and Channels
  • Removing Configured Teams and Channels From a Group
  • Viewing Users Belonging to The Group
  • Disabling and Re-activating AD/LDAP Users
  • Managing Groups
  • Deleting Groups
  • Using AD/LDAP Synchronized Groups to Manage Team or Private Channel Membership
  • Frequently Asked Questions
• Using AD/LDAP Synchronized Groups to Manage Team or Private Channel Membership
  • Managing Membership of a Team or Channel with Synchronized Groups
  • Add or Remove Groups from Teams
  • Add or Remove Groups from Private Channels
  • Managing Members
  • Disabling Group Synchronized Management of Teams and Private Channels
  • FAQs
• SAML Single Sign-On (E20)
  • Okta SAML Configuration
  • OneLogin SAML Configuration
  • Microsoft ADFS SAML Configuration for Windows Server 2012
  • Microsoft ADFS SAML Configuration for Windows Server 2016
  • Using SAML Attributes to Apply Roles
  • Roadmap
  • Configuration Assistance
• SAML Single-Sign-On (E20): Technical Documentation
  • SAML Providers
  • SAML Request (AuthNRequest)
  • SAML Responses
  • Technical description of SAML synchronization with AD/LDAP
  • Frequently Asked Questions
• OpenID Connect Single Sign-On (E20)
  • Step 1: Create an OpenID Connect Application
  • Step 2: Configure Mattermost for an OpenID Connect SSO
• GitLab Single Sign-On
  • Step 1: Add an application to your GitLab account
  • Step 2: Configure Mattermost for GitLab SSO
  • (Optional) Step 3: Force users to sign up using SSO only
• Google Single Sign-On (E20)
  • Migrating from OAuth 2.0 to OpenID Connect
  • Configuring Google Apps as a Single Sign-On (SSO) service
• Office 365 Single Sign-On (E20)
  • Migrating from OAuth to OpenID Connect
  • Configuring Office 365 as a Single Sign-On (SSO) service
• Converting OAuth 2.0 Service Providers to OpenID Connect (E20)
  • Configuring OpenID Connect Single Sign-On
• SSL Client Certificate Setup (Beta)
  • Set up mutual TLS authentication for the Web App
  • Troubleshooting
• Certificate-Based Authentication (Experimental)
  • Set up mutual TLS authentication for the Web App
  • Set up Mattermost server to log in with a client certificate
• Managing Team and Channel Members (E20)
  • Teams
  • Channels
• Advanced Permissions (E10/E20)
  • Permissions Structure
  • Channel Permissions
  • Recipes
  • Administration Tools
  • Backend Infrastructure
  • Glossary
• Advanced Permissions: Backend Infrastructure
  • Entity Definitions
  • Data Structure
• Guest Accounts (Beta) (E10/E20)
  • Enabling Guest Accounts
  • Guest Authentication
  • Inviting Guests to the Mattermost Server via Email
  • Configuring AD/LDAP Authentication
  • Configuring SAML 2.0 Authentication
  • Guest Permission Settings
  • Guest Identification
  • Managing Guests
  • Disabling Guest Accounts
  • Reinstating Guest Accounts
  • Frequently Asked Questions

Administration

Learn how to maintain your Mattermost system.

• Command Line Tools
  • Using the CLI
  • Mattermost 3.6 and later
  • Mattermost 3.5 and earlier
  • Troubleshooting
• mmctl Command Line Tool (Beta)
  • Installing mmctl
  • Building mmctl
  • Local mode
  • Running mmctl tests
  • mmctl auth
  • mmctl bot
  • mmctl channel
  • mmctl command
  • mmctl completion
  • mmctl config
  • mmctl docs
  • mmctl export
  • mmctl group
  • mmctl group channel
  • mmctl group team
  • mmctl import
  • mmctl integrity
  • mmctl ldap
  • mmctl license
  • mmctl logs
  • mmctl permissions
  • mmctl plugin
  • mmctl plugin marketplace
  • mmctl post
  • mmctl roles
  • mmctl system
  • mmctl team
  • mmctl team users
  • mmctl token
  • mmctl user
  • mmctl version
  • mmctl webhook
  • mmctl websocket
• Scripts
• Statistics
  • Site Statistics
  • Team Statistics
  • Troubleshooting/FAQ
• User Satisfaction Surveys
  • Administration
  • Survey Data
• In-Product Notices
  • Administrator notices
  • End user notices
  • Admin Advisor notices
• Health Check
  • /ping APIv4 Endpoint
  • Mattermost Probe
• Announcement Banner (E10)
• Bulk Export Tool
  • Bulk export data
  • Running the bulk export command
• Generating a Support Packet (E10/E20)

Troubleshooting

Understand potential issues and how to address them.

• Important Notes
• General Troubleshooting
• Administration Issues
• SAML issues
• Deployment and Clustering
• Server Administration
• Settings
• Mobile
• Configuration Issues
• None of These Solve my Problem!
• Opening a Support Ticket for Self-Managed Deployments
• Appendix
• MySQL Installation Troubleshooting

Upgrade Mattermost

Learn how to keep Mattermost current with fixes and new features.

• Upgrading Mattermost Server
  • Upgrading to the Latest Version
  • Upgrading Team Edition to Enterprise Edition
  • Uploading a License Key
• Important Upgrade Notes
• Mattermost Changelog
  • Release v5.34 - Feature Release
  • Release v5.33 - Feature Release
  • Release v5.32 - Feature Release
  • Release v5.31 - ESR
  • Release v5.30 - Feature Release
  • Release v5.29 - Quality Release
  • Release v5.28 - Feature Release
  • Release v5.27 - Quality Release
  • Release v5.26 - Feature Release
  • Release v5.25 - ESR
  • Release v5.24 - Feature Release
  • Release v5.23 - Quality Release
  • Release v5.22 - Feature Release
  • Release v5.21 - Quality Release
  • Release v5.20 - Feature Release
  • Release v5.19 - ESR
  • Release v5.18 - Feature Release
  • Release v5.17 - Quality Release
  • Release v5.16 - Feature Release
  • Release v5.15 - Quality Release
  • Release v5.14 - Feature Release
  • Release v5.13 - Quality Release
  • Release v5.12 - Feature Release
  • Release v5.11 - Quality Release
  • Release v5.10 - Feature Release
  • Release v5.9 - ESR
  • Release v5.8 - Feature Release
  • Release v5.7 - Quality Release
  • Release v5.6 - Feature Release
  • Release v5.5 - Quality Release
  • Release v5.4 - Feature Release
  • Release v5.3 - Feature Release
  • Release v5.2 - Feature Release
  • Release v5.1 - Feature Release
  • Release v5.0 - Feature Release
  • Release v4.10 - ESR
  • Release v4.9 - Feature Release
  • Release v4.8 - Feature Release
  • Release v4.7 - Feature Release
  • Release v4.6 - Feature Release
  • Release v4.5 - Feature Release
  • Release v4.4.5 - Feature Release
  • Release v4.3.4 - Feature Release
  • Release v4.2.2 - Feature Release
  • Release v4.1.2 - Feature Release
  • Release v4.0.5 - Feature Release
  • Release v3.10.3
  • Release v3.9.2
  • Release v3.8.3
  • Release v3.7.5
  • Release v3.6.7
  • Release v3.5.1
  • Release v3.4.0
  • Release v3.3.0
  • Release v3.2.0
  • Release v3.1.0
  • Release v3.0.3
  • Release v2.2.0
  • Release v2.1.0
  • Release v2.0.0
  • Release v1.4.0
  • Release v1.3.0
  • Release v1.2.1
  • Release v1.2.0 (Redacted Release)
  • Release v1.1.1 (Quality Release)
  • Release v1.1.0
  • Release v1.0.0
  • Release v0.7.0 (Beta1)
  • Release v0.6.0 (Alpha)
  • Release v0.5.0 (Preview)
• Desktop Application Changelog
  • Release v4.6
  • Release v4.5
  • Release v4.4
  • Release v4.3
  • Release v4.2.3
  • Release v4.2.2
  • Release v4.2.1
  • Release v4.2.0
  • Release v4.1.2
  • Release v4.1.1
  • Release v4.1.0
  • Release v4.0.1
  • Release 4.0.0
  • Release 3.7.1
  • Release 3.7.0
  • Release 3.6.0
  • Release v3.5.0
  • Release v3.4.1
  • Release v1.3.0
  • Release v1.2.1 (Beta)
  • Release v1.1.1 (Beta)
• Mattermost Mobile Apps Changelog
  • 1.42.0 Release
  • 1.41.1 Release
  • 1.41.0 Release
  • 1.40.0 Release
  • 1.39.0 Release
  • 1.38.1 Release
  • 1.38.0 Release
  • 1.37.0 Release
  • 1.36.0 Release
  • 1.35.1 Release
  • 1.35.0 Release
  • 1.34.1 Release
  • 1.34.0 Release
  • 1.33.1 Release
  • 1.33.0 Release
  • 1.32.2 Release
  • 1.32.1 Release
  • 1.32.0 Release
  • 1.31.2 Release
  • 1.31.1 Release
  • 1.31.0 Release
  • 1.30.1 Release
  • 1.30.0 Release
  • 1.29.0 Release
  • 1.28.0 Release
  • 1.27.1 Release
  • 1.27.0 Release
  • 1.26.2 Release
  • 1.26.1 Release
  • 1.26.0 Release
  • 1.25.1 Release
  • 1.25.0 Release
  • 1.24.0 Release
  • 1.23.1 Release
  • 1.23.0 Release
  • 1.22.1 Release
  • 1.22.0 Release
  • 1.21.2 Release
  • 1.21.1 Release
  • 1.21.0 Release
  • 1.20.2 Release
  • 1.20.1 Release
  • 1.20.0 Release
  • 1.19.0 Release
  • 1.18.1 Release
  • 1.18.0 Release
  • 1.17.0 Release
  • 1.16.1 Release
  • 1.16.0 Release
  • 1.15.2 Release
  • 1.15.1 Release
  • 1.15.0 Release
  • 1.14.0 Release
  • 1.13.1 Release
  • v1.13.0 Release
  • v1.12.0 Release
  • v1.11.0 Release
  • v1.10.0 Release
  • 1.9.3 Release
  • 1.9.2 Release
  • 1.9.1 Release
  • v1.9.0 Release
  • v1.8.0 Release
  • v1.7.1 Release
  • v1.7.0 Release
  • v1.6.1 Release
  • v1.6.0 Release
  • v1.5.3 Release
  • v1.5.2 Release
  • v1.5.1 Release
  • v1.5 Release
  • v1.4.1 Release
  • v1.4 Release
  • v1.3 Release
  • v1.2 Release
  • v1.1 Release
  • v1.0.1 Release
  • v1.0 Release
  • Beta Release
• Version Archive
  • Mattermost Enterprise Edition
  • Mattermost Team Edition Server Archive
• Extended Support Release
  • What is an Extended Support Release?
  • What is the life cycle of an Extended Support Release?
  • What is included in an Extended Support Release dot release?
  • Who should use an Extended Support Release?
  • How do I install the Extended Support Release?
  • What are the current supported Extended Support Release versions?
  • How do I restore a previous Extended Support Release?
  • Why is an Extended Support Release supported for 9 months and not longer?
  • Can customers pay for extended support?
  • How do we notify customers about new and deprecated Extended Support Releases?
• Release Lifecycle
  • What is a Release Lifecycle?
• Downgrading Mattermost Server
  • Downgrade from 5.0 to 4.10
• Open Source Components
  • Desktop
  • Mobile
  • Redux
  • Server
  • Webapp
• Release Definitions
  • Feature Release
  • Quality Release
  • Extended Support Release (ESR)

Mattermost Integrations

Learn how to extend Mattermost by integrating your workflows.

• Mattermost Developer Toolkit
  • More Power for Developers
  • Better Control for System Admins
  • Features of the Developer Toolkit
  • Example Uses
• Atlassian Tools
  • Jira Plugin
  • Jira Atlassian App
  • Bitbucket
  • Confluence
  • Opsgenie
  • Statuspage
  • Trello
• Microsoft Tools
  • Office 365 Calendar (E20)
  • Skype for Business
  • Office 365 SSO (E20)
  • Collabora Online
• CI/CD Tools
  • GitHub
  • GitLab
  • Jenkins Plugin
  • Jenkins
  • Bitbucket
• Incident Response and Monitoring Tools
  • AWS CloudWatch SNS
  • Nagios
  • Splunk
  • PagerDuty
  • Opsgenie
  • Prometheus Alertmanager
• Bots
  • WelcomeBot
  • BotKube
  • Sample Golang bot
  • Hubot Adapter
  • Python Chatbot
• Voice, video, and screensharing
  • Zoom
  • Microsoft Teams Meetings
  • Cisco Webex Cloud
  • BigBlueButton
  • Skype for Business (Beta)
  • WebRTC
  • Kopano WebMeetings
  • Jitsi
  • SIP PBX
  • appear.in
• Productivity Tools
  • Matterpoll for polls
  • Google Calendar
  • CloudApp
  • Gyazo
  • Autotranslation Plugin
  • Remind Plugin

Mattermost Compliance

Learn how to adhere to your security and regulations.

• Electronic Discovery
  • Mattermost Compliance Exports
  • Mattermost RESTful API
  • Mattermost Database
• Compliance Reporting and Oversight (E20)
  • Enabling Compliance Reporting
  • Turn on Daily Compliance Reports
  • Run Compliance Reports
  • Global Relay Support
• Compliance Export Beta (E20)
  • Set Up Guide
  • Frequently Asked Questions (FAQ)
• Audit Log v2 (Experimental) (E20)
  • Configure audit log in Mattermost
  • Supported logging events
  • Data model
  • Log storage
  • Planned enhancements to the audit log
  • Planned enhancements to logging in general
• Data Retention Policy (E20)
  • Configuring a Data Retention Policy
  • Frequently Asked Questions (FAQs)
• Custom Terms of Service (Beta) (E20)
  • Configuring Terms of Service
  • Frequently Asked Questions

Scaling Mattermost

Learn how to support growth within Mattermost.

• Scaling for Enterprise
  • Single Machine Deployment
  • Multi Machine Deployment
  • Cluster-based Deployment
  • Sample Scaling Guide
  • Hosting Recommendation for 100,000+ users
• High Availability Cluster (E20)
  • Requirements for Continuous Operation
  • Deployment Guide
  • Configuration and Compatibility
  • Upgrade Guide
  • Frequently Asked Questions (FAQ)
  • Troubleshooting
• High Availability Cluster (v3.10 and earlier)
  • Requirements for Continuous Operation
  • Deployment Guide
  • Configuration and Compatibility
  • Upgrade Guide
  • Troubleshooting
• Elasticsearch (E20)
  • Deployment Guide
  • Limitations
  • Frequently Asked Questions (FAQ)
• Performance Monitoring (E20)
  • Deployment Guide
  • Installing Prometheus
  • Installing Grafana
  • Getting Started
  • Statistics
  • Frequently Asked Questions
• Mattermost Performance Alerting Guide
  • CPU Utilization Rate
  • Memory Usage
  • Number of Goroutines
  • Number of API Errors per Second
  • Mean API Request Time
  • Plugin Hooks
  • Other Alerts

Community-Managed Documentation

Documentation on early previews and unofficial functionality.

• Production Install on Windows Server (Unofficial)
• Deploy Mattermost on Docker
• Deploy Mattermost on Cloudron (Unofficial)
• Upgrading Mattermost Server with a Script
• लाइट इनस्टॉल गाइड