Edit on GitHub

Troubleshooting Kubernetes at Mattermost

This page helps developers access and perform any type of maintenance in the Production Mattermost Kubernetes Cluster, which is running on AWS using EKS.

Set up a local environment to access Kubernetes (K8s) 

  1. Make sure you have kubectl version 1.10 or later installed. If not, follow these instructions.

  2. Use your OneLogin account to retrieve AWS Keys for the main Mattermost AWS account following these instructions to install onelogin-aws command line application.


  • run onelogin-aws-login in the command line, it will ask your username, password and the two-factor auth.
  • select arn:aws:iam::521493210219:role/OneLoginPowerUsers
  • export the environment variable AWS_PROFILE which will be something like 521493210219/OneLoginPowerUsers/YOUR_EMAIL
  1. Install aws-iam-authenticator following these instructions section To install aws-iam-authenticator for Amazon EKS.

  2. Get the kubeconfig

Cluster Name: mattermost-prod-k8s

$ aws eks update-kubeconfig --name mattermost-prod-k8s --region us-east-1
  1. Confirm the set up is correct by checking if the puds are running in the K8s cluster:
$ kubectl get po -n community
NAME                                              READY   STATUS    RESTARTS   AGE
mattermost-community-0                            1/1     Running   0          5h
mattermost-community-1                            1/1     Running   0          23h
mattermost-community-jobserver-65985bfc47-88qq9   1/1     Running   0          5h

$ kubectl get po -n community-daily
NAME                                                    READY   STATUS    RESTARTS   AGE
mattermost-community-daily-0                            1/1     Running   0          3h
mattermost-community-daily-1                            1/1     Running   0          3h
mattermost-community-daily-jobserver-78f7cbf756-wls4f   1/1     Running   0          2h

If one or more pods show a status other than Running, use kubectl describe and kubectl logs to troubleshoot:

$ kubectl describe pods ${POD_NAME} -n ${NAMESPACE}
$ kubectl logs pods ${POD_NAME} -n ${NAMESPACE}


We are using two namespaces to deploy Mattermost

- `community` namespace holds the Mattermost deployment which uses the Release Branch or a stable release. The ingress is points to `https://community.mattermost.com/` and `https://pre-release.mattermost.com/`
- `community-daily` namespace holds the Mattermost deployment which uses the `master` branch. The ingress points to `https://community-daily.mattermost.com/`


This section will be populated nas we run into issues and find solutions to them.

Did you find what you were looking for?

Thank you! We appreciate your feedback.

Tell us more

Your feedback helps us improve the Mattermost developer documentation.

Have a feature request? Share it here.

Having issues? Join our Community server.