---
title: Charmhub | Deploy Mattermost using Charmhub - The Open Operator Collection
description: Deploy the latest version of Mattermost as a Kubernetes Operator on any
  cloud.
url: https://charmhub.io/mattermost-k8s/docs/add-plugins-custom-images
---

# Mattermost

[Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

* [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

Platform:

stable 18

```
juju deploy mattermost-k8s
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Contacts

##### Maintainers

+ [Launchpad Team](https://launchpad.net/~canonical-is-sre)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# How to add plugins and custom images

Images are built via an [OCI Recipe on Launchpad](https://launchpad.net/~mattermost-charmers/charm-k8s-mattermost/+oci/mattermost/+recipe/mattermost) and pushed to [mattermostcharmers/mattermost](https://hub.docker.com/r/mattermostcharmers/mattermost/tags) on dockerhub. Each image is tagged with the version number of Mattermost that it was built with (e.g. `5.29.0` ). The images published there are built using [this Dockerfile](https://git.launchpad.net/~mattermost-charmers/charm-k8s-mattermost/+git/charm-k8s-mattermost/tree/Dockerfile).

## [Plugins](https://charmhub.io/mattermost-k8s/docs/add-plugins-custom-images#p-10117-plugins)

Plugins are also managed via the image build. The image builder does not enable any additional plugins by default, but examples of enabling prepackaged and downloaded plugins via the `image_flavour` build argument can be found [on line 32 of the Dockerfile](https://git.launchpad.net/~mattermost-charmers/charm-k8s-mattermost/+git/charm-k8s-mattermost/tree/Dockerfile#n32).

## [Webapp Customizations](https://charmhub.io/mattermost-k8s/docs/add-plugins-custom-images#p-10117-webapp-customizations)

To deploy [changes to the Mattermost webapp](https://docs.mattermost.com/deployment/customize-mattermost.html#mattermost-webapp) itself (for example, we wrote a patch to add branded themes to our deployment) see [line 39 onwards of the Dockerfile](https://git.launchpad.net/~mattermost-charmers/charm-k8s-mattermost/+git/charm-k8s-mattermost/tree/Dockerfile#n39) for details.

## [Local Image Builds](https://charmhub.io/mattermost-k8s/docs/add-plugins-custom-images#p-10117-local-image-builds)

```
git clone https://git.launchpad.net/~mattermost-charmers/charm-k8s-mattermost/+git/image-build mattermost-image-build
docker build -t localhost:32000/mattermost ./mattermost-image-build
docker push localhost:32000/mattermost
```

Then, to use your new image, either replace the `deploy` step above with

```
juju deploy ./charm-k8s-mattermost/mattermost.charm --config mattermost_image_path=localhost:32000/mattermost:latest mattermost
```

or, if you’ve already deployed mattermost:

```
juju config mattermost mattermost_image_path=localhost:32000/mattermost:latest
```

---