selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

mattermost logo

Self-host mattermost

v11.7.15

Open-core team chat for DevSecOps and incident response

ReleaseOpen CoreOther
Updatedlast week
LanguageTypescript
Setup difficultyModerate
MobileNative app
Stars
39 616
CPU
1 vCPU
RAM
2 GB RAM (supports up to ~1,000 users)
Ports
8065 (HTTP/Websocket server and System Console), 8067 (Metrics endpoint)
Requires
PostgreSQL
Docker
mattermost/mattermost-enterprise-edition
Install with Docker Compose
Web app UI with channel sidebar and message listChannel with a mission briefing, files and messagesIncident playbook run with a task checklistGroup call screen with participants and host controlsSystem Console screen for data retention policiesBoards tracker with task columns for a missionChannel with a GitLab bot pipeline message and slash-command menuChannel showing a classification banner and access rules

What is mattermost?

mattermost alternatives

Should you self-host mattermost?

mattermost scores 80/100 on selfhost.directory (how scoring works) and ranks #2 of 110 in Chat. It has 39 616 GitHub stars, +294 in the last 30 days.

It shipped 46 stable releases in the past year. The latest, v12.1.0, came out on 5 November 2026. New versions land roughly every 1 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Zulip (82/100, 26 236 stars). It scores higher overall, so compare the two before you pick. See mattermost vs Zulip side by side.

Features

  • Bring-your-own LLM integration
  • Channel-based team messaging
  • Chatbot
  • Custom themes and branding
  • FederationFederated communications is listed as an Enterprise-tier capability.
  • File sharing
  • Full-Text Search
  • Guest AccountsGuest account management is listed among all offerings on the pricing page.
  • High availability clusteringScale and high availability features sit in the Enterprise tier of the pricing page.
  • Plugin System
  • REST API
  • Threaded discussions
  • Voice calls and screen sharing
  • Webhooks
  • Workflow automation (playbooks)Playbooks and workflow automation are listed under the paid Enterprise tier on the pricing page.

mattermost README

Mattermost logo

Mattermost is an open core, self-hosted collaboration platform that offers chat, workflow automation, voice calling, screen sharing, and AI integration. This repo is the primary source for core development on the Mattermost platform; it's written in Go and React, runs as a single Linux binary, and relies on PostgreSQL. A new compiled version is released under an MIT license every month on the 16th.

Deploy Mattermost on-premises, or try it for free in the cloud.

mattermost user interface

How to install mattermost

Install mattermost with Docker Compose

Environment variables
DOMAIN, MATTERMOST_IMAGE, MATTERMOST_IMAGE_TAG, MM_SQLSETTINGS_DRIVERNAME, MM_SQLSETTINGS_DATASOURCE, MM_SERVICESETTINGS_SITEURL
git clone https://github.com/mattermost/docker
cd docker
cp env.example .env
mkdir -p ./volumes/app/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes}
sudo chown -R 2000:2000 ./volumes/app/mattermost
docker compose -f docker-compose.yml -f docker-compose.nginx.yml up -d

Deployment results in separate database and application containers, with an optional NGINX reverse-proxy container. Officially supported on Linux only; macOS and Windows Docker deployments are supported for testing and development purposes only.

How to configure mattermost

  • MM_SQLSETTINGS_DRIVERNAMEpostgresBelow one can find necessary settings to spin up the Mattermost container
  • MM_SQLSETTINGS_DATASOURCEpostgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB}?sslmode=disable&connect_timeout=10
  • MM_SERVICESETTINGS_SITEURLhttps://${DOMAIN}Example settings (any additional setting added here also needs to be introduced in the docker-compose.yml)
  • DOMAINDomain of service
  • RESTART_POLICYunless-stoppedContainer settings Timezone inside the containers. The value needs to be in the form 'Europe/Berlin'. A list of these tz database names can be looked up at Wikipedia https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

mattermost releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Does Mattermost have a Software-as-a-Service offering?

Yes, enterprises can ask about Mattermost Cloud Enterprise, a single-tenant managed service running on the same Kubernetes platform as the self-hosted edition.

Can I use my Mattermost license on multiple servers?

No: every Mattermost server needs its own license, including federated ones, though an HA cluster sharing one database counts as a single server.

Do you offer special programs for non-profit organizations, open source projects, or educational institutions?

Yes, Mattermost runs non-profit subscription programs described in its documentation.

What happens when activated users exceed the number of licensed seats?

Extra seats are bought on a quarterly true-forward basis, prorated for the rest of the annual license period.

I’d like to buy Mattermost through a reseller–or I am a reseller–how do I get in touch?

Contact the sales team to find a reseller for your geography; resellers can read about the partner programs on the partner page.

How can governmental organizations outside the U.S. procure Mattermost licenses?

Non-U.S. government buyers are pointed to the Mattermost sales team, which can connect them with approved resellers by country or onboard a new reseller.

More in Chat

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…