Mattermost is an open core, self-hosted collaboration platform combining chat, workflow automation, voice calling, screen sharing, and AI integration. This repository is the primary source for core development of the platform: it's written in Go and React, runs as a single Linux binary, and relies on PostgreSQL for storage. It's aimed at organizations that want a Slack-like chat platform they control and host themselves, or that need it for regulated or security-sensitive environments.
Mattermost fits teams and organizations that want a chat platform under their own control, whether for data residency, compliance, or internal policy reasons, and that are willing to run the infrastructure to host it. The DevSecOps, incident resolution, and IT service desk use cases documented by the project point to teams that need chat tied into operational workflows, not just casual messaging. Organizations already comfortable managing PostgreSQL-backed services will find the single-binary deployment model straightforward.
It's less suited to small teams or individuals who just want a quick group chat without any hosting responsibility; Mattermost also offers a cloud sign-up for that case, but the self-hosted server in this repository assumes you're prepared to install, configure, and maintain it, or use one of the documented deployment paths like Docker or Kubernetes. If you don't need self-hosting control, a fully managed SaaS chat tool may be simpler to adopt.
Mattermost Self-Hosted can be deployed in minutes through several supported paths, documented in the deployment guide. A few of the most common options:
# Docker
# Follow the Docker install guide for a containerized deployment
# Tar package
# Download and extract the tar release for manual installation
# Kubernetes / Helm
# Install via the Kubernetes operators, or via Helm
Specific guides are also provided for Mattermost Omnibus, Ubuntu 20.04 LTS, Debian Buster, and RHEL 8, alongside the general server install guides.
If you'd rather not run your own infrastructure, you can sign up for the cloud-hosted version instead and skip deployment entirely.
For developers who want to write code for Mattermost itself, follow the developer machine setup guide, which walks through preparing a local environment for contributing to the server.
To stay informed about critical security releases, subscribe to the Mattermost Security Bulletin mailing list, since the project notes that the sophistication of online attackers is perpetually increasing and recommends this for anyone running a self-hosted instance.
Contribution guidelines, including how to find "Help Wanted" issues and join developer discussion on the community Mattermost server, are documented in CONTRIBUTING.md.