- Deploy the Mattermost Team Edition Helm chart
- Deploy GitLab Helm chart
- Create an OAuth application with GitLab
This document describes how to install Mattermost Team Edition Helm chart in proximity with an existing GitLab Helm chart deployment.
As the Mattermost Helm chart is installed in a separate namespace, it is recommended that
nginx-ingress be configured to manage cluster-wide Ingress and certificate resources. For additional configuration information,
refer to the Mattermost Helm configuration guide.
- A running Kubernetes cluster.
- Helm v3
Once you have installed the Mattermost Team Edition Helm chart, you can deploy it using the following command:
helm repo add mattermost https://helm.mattermost.com helm repo update helm upgrade --install mattermost -f values.yaml mattermost/mattermost-team-edition
Wait for the pods to run. Then, using the Ingress host you specified in the configuration, access your Mattermost server.
For additional configuration information, refer to the Mattermost Helm configuration guide. you experience any issues with this, please view the Mattermost Helm chart issue repository or the Mattermost Forum.
To deploy the GitLab Helm chart, follow the instructions described here.
Here’s a light way to install it:
helm repo add gitlab https://charts.gitlab.io/ helm repo update helm upgrade --install gitlab gitlab/gitlab \ --timeout 600s \ --set global.hosts.domain=<your-domain> \ --set global.hosts.externalIP=<external-ip> \ --set certmanager-issuer.email=<email>
<your-domain>: your desired domain, such as
<external-ip>: the external IP pointing to your Kubernetes cluster.
<email>: email to register in Let’s Encrypt to retrieve TLS certificates.
Once you’ve deployed the GitLab instance, follow the instructions for the initial login.
The next part of the process is setting up the GitLab SSO integration. To do so, you need to create the OAuth application to allow Mattermost to use GitLab as the authentication provider.
If you are following a process other than the one provided and experience authentication and/or deployment issues, let us know in the Mattermost troubleshooting forum.