Mattermost Helm Chart

Self-hosted team messaging: channels, threads, direct messages and file sharing.

Chart version: 1.0.0
App version: 11.7.14
Changelog: CHANGELOG.md

Website: mattermost.com
Releases: GitHub
Docs: docs.mattermost.com

Configuration

The chart is built on top of the Standard chart; see the values.yaml for all configuration options.

Everything under mattermost: in values.yaml is a Standard chart value. That covers ingresses with TLS, persistent volumes, variables and secrets, sealed secrets, mounted files, jobs, cron jobs, init and sidecar containers, and autoscaling. The values reference lists every option.

Install

helm repo add hosst https://hosstio.github.io/helm-charts
helm install mattermost hosst/mattermost --values values.yaml

Two values have no working default, so set both in your values file:

mattermost:
  variables:
    MM_SERVICESETTINGS_SITEURL: https://chat.example.com
  secrets:
    MM_CONFIG: postgres://mattermost:password@postgres:5432/mattermost?sslmode=require

Configure

MM_CONFIG is a PostgreSQL DSN. Mattermost connects to that database and also keeps its configuration there, so changes made in the System Console survive a restart. A setting under variables or secrets overrides the stored value, and the System Console shows it as locked.

Uploads go to the data volume at /data, 10Gi unless you set persistence.data.size. The deployment uses the Recreate strategy: an unlicensed Mattermost runs a single server, and the volume is ReadWriteOnce.

The pod sets fsGroupChangePolicy: OnRootMismatch, so kubelet only changes the ownership of the files when /data itself lacks group 2000. Files copied in with another group keep it. To fix them, start the pod once with podSecurityContext.fsGroupChangePolicy: Always.

The image is the official Team Edition, mattermost/mattermost-team-edition. Without a licence, Team Edition refuses to create or activate users past 250 active users.

The startup probe waits up to 15 minutes, because Mattermost runs the database migrations of a version upgrade before it starts listening.

Links

• Website: mattermost.com
• Releases: GitHub
• Docs: docs.mattermost.com