In-depth documentation on installation, deployment and administration of Mattermost system.
Use the following materials as a template to help you plan and document the implementation of Mattermost at your organization.
Learn how to get Mattermost running on your environment.
- Software and Hardware Requirements
- Installing on Ubuntu 16.04 LTS
- Installing on Ubuntu 18.04 LTS
- Installing on Kubernetes
- Installing on Debian Stretch
- Installing on RHEL 6
- Installing on RHEL 7
- Installing on CentOS, Oracle Linux, and Scientific Linux
- Instructions On Setting Up a Socket-based Mattermost Database
- Enterprise Install and Upgrade
- Deploy Mattermost on Bitnami
- Local Machine Setup using Docker
- Production Docker Deployment
- AWS Elastic Beanstalk Docker Setup
- Deploy Mattermost on Cloudron (Unofficial)
- Installing Mattermost Team Edition in GitLab Helm Chart
- MySQL Installation Troubleshooting
- Desktop Application Install Guides
- Desktop MSI Installer and Group Policy Installation Guides (Alpha)
- SMTP Email Setup
- Configuring CloudFront to host Mattermost static assets
- Using an Outbound Proxy
- Chinese, Japanese and Korean Search
- Configuring Apache2 (Unofficial)
Learn how to host Mattermost to meet your networking requirements.
- Deployment Overview
- Desktop App Deployment Guide
- AppConfig for EMM Solutions with Mattermost Mobile Apps
- Image Proxy
- Encryption Options
- Client-side Data Storage FAQ
- Backup and Disaster Recovery
Learn how to configure settings to meet your unique requirements.
- Administrator Tasks
- Configuration Settings
- Configuration in the Mattermost Database
- Configuration Settings Prior to v5.12
- Customizing Mattermost
- Email Templates
- Custom Branding Tools
Learn how to configure and administer Mattermost apps.
- Mobile Applications Guide
- AppConfig for EMM Solutions with Mattermost Mobile Apps
- Hosted Push Notification Service
- 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?
- What are my options for securing the mobile apps?
- What are my options for securing push notifications?
- How do I white label the app and customize build settings?
- How do I pre-configure the server URL for my users?
- How can I get Google SSO to work with the Mattermost Mobile Apps?
- 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
- No image previews available in the mobile app
- None of these solve my problem!
Learn how to get your users into and comfortable using Mattermost.
- Bulk Loading Data
- Migration Guide
- Migrating from HipChat to Mattermost
- Migration Announcement Email
- Provisioning Workflows
- Active Directory/LDAP Setup (E10/E20)
- Multi-Factor Authentication
- AD/LDAP Groups (Experimental) (E20)
- Pre-installation notes
- Enable AD/LDAP group synchronization
- AD/LDAP group synchronization
- Linking AD/LDAP groups to Mattermost groups
- Configure the group
- Add default teams or channels for the group
- Teams and channels membership synchronization
- Remove configured teams and channels from a group
- View users belonging to the group
- Disabling and re-activating LDAP/AD users
- Managing groups
- Deleting groups
- Frequently Asked Questions
- Using AD/LDAP Synchronized Groups to Manage Team or Private Channel Membership
- SAML Single-Sign-On (E20)
- SAML Single-Sign-On (E20): Technical Documentation
- GitLab Single Sign-On
- Google Single Sign-On (E20)
- Office 365 Single Sign-On (E20)
- SSL Client Certificate Setup (Beta)
- Certificate-Based Authentication (Experimental)
- Advanced Permissions (E10/E20)
- Advanced Permissions: Backend Infrastructure
Learn how to maintain your Mattermost system.
- Command Line Tools
- User Satisfaction Surveys
- Health Check
- Announcement Banner (E10)
- Bulk Export Tool
Learn how to keep Mattermost current with fixes and new features.
- Upgrading Mattermost Server
- Important Upgrade Notes
- Mattermost Changelog
- 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
- 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)
- Version 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 ESR versions?
- How do I restore a previous Extended Support Release?
- Release Lifecycle
- Downgrading Mattermost Server
- Open Source Components
Learn how to extend Mattermost by integrating your workflows.
- Mattermost Developer Toolkit
- Atlassian Tools
- CI/CD Tools
- Incident Response and Monitoring Tools
- Voice, Video and Screensharing
- Productivity Tools
Learn how to adhere to your security and regulations.
- Electronic Discovery
- Compliance Reporting and Oversight (E20)
- Compliance Export Beta (E20)
- Data Retention Policy (E20)
- Custom Terms of Service (Beta) (E20)
Learn how to support growth within Mattermost.
- Scaling for Enterprise
- High Availability Cluster (E20)
- High Availability Cluster (v3.10 and earlier)
- Elasticsearch (E20)
- Performance Monitoring (E20)
- Mattermost Performance Alerting Guide