Install Mattermost on Kubernetes

How to install Mattermost on Kubernetes with use of Helm

Mattermost Messaging Software Mattermost screenshot

Mattermost Messaging Software

33,500 GitHub stars

How to Install Mattermost on Kubernetes with Helm

This guide will walk you through the process of installing Mattermost using Helm, the Kubernetes package manager, ensuring a smooth and efficient setup.

Prerequisites

Before we begin, ensure you have the following tools installed and configured:

  • Kubernetes - Installed locally or in a public cloud provider
  • kubectl - Configured to communicate with your Kubernetes cluster
  • Helm - For managing Kubernetes applications like Mattermost
  • Kubernetes Ingress controller - For accessing the installation on a url

Step 1: Add the Helm chart repository

First, add the repository containing the Mattermost helm chart:

helm repo add mattermost https://helm.mattermost.com
helm repo update
helm search repo mattermost

Step 2: Create a namespace (optional)

Isolating applications within Kubernetes namespaces is a good practice. To deploy Mattermost in its own namespace:

kubectl create namespace mattermost

Step 3: Install Mattermost using Helm

Now, you'll install Mattermost. The helm chart name is "mattermost":

helm install mattermost mattermost/mattermost --namespace mattermost --create-namespace

Step 4: Verify the installation

After installation, verify that your Mattermost deployment is running smoothly:

kubectl get pods --namespace mattermost
kubectl get all --namespace mattermost

Step 5: Customize the Mattermost installation (optional)

This process may require customizing your deployment through a customized values.yaml file, which specifies configuration options.

helm install mattermost mattermost/mattermost --values values.yaml --namespace mattermost

Step 6: Access Mattermost

Accessing Mattermost will depend on your chosen service configuration (LoadBalancer, NodePort, or Ingress). For Ingress access, ensure an Ingress controller is operational in your cluster.

Follow the instructions in the helm install notes, the output of Step 3.

We can install Mattermost for you

Fully managed and 14 day free trial and 100% money back guarantee

Standard

$99 / month

  • Up to 10 users
  • Unlimited chat history
  • 10GB storage
  • Email support
  • Custom domain with SSL
Start free trial

Premium

$249 / month

  • Up to 100 users
  • Unlimited chat history
  • 100GB storage
  • Priority email support
  • Custom domain with SSL
  • Single Sign-On integrations
  • Data migration
Start free trial

Custom

starts at $499 / month

  • Unlimited users
  • Unlimited chat history
  • Unlimited storage (25 EUR per 100GB)
  • Live chat (Slack) support
  • Custom domain with SSL
  • Single Sign-On integrations
  • Data migration
  • High availability (SLA)
  • Special requirements
Contact us

Annual Get 2 months for free, 17% discount on a yearly plan!

We love open source

We contribute 10% of our revenue back to 61 open source projects

Directly to projects, via GitHub Sponsors and Open Collective.