---
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/upgrade
---

# 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 upgrade

## [Mattermost application upgrades](https://charmhub.io/mattermost-k8s/docs/upgrade#p-10119-mattermost-application-upgrades)

Mattermost version upgrades are done by updating the `mattermost_image_path` juju config variable to point to an image with a newer version of Mattermost than the one currently deployed.

As an example, if `mattermost_image_path` is set to `mattermostcharmers/mattermost:5.27.0`, running the following will trigger an upgrade:

```
juju config mattermost mattermost_image_path="mattermostcharmers/mattermost:5.29.0"
```

Juju, Kubernetes, and Mattermost then work together to ensure that one pod is upgraded to the new version and makes any database schema changes before the rest of the pods are upgraded in their turn.

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`).

Alternatively, you can also build a new image locally with the version required and update the `mattermost_image_path` config option to point to wherever you’ve published the image.

## [Charm upgrades](https://charmhub.io/mattermost-k8s/docs/upgrade#p-10119-charm-upgrades)

If you have deployed Mattermost from the charmstore directly, you can upgrade to a new charm version by simply running [the juju refresh command](https://juju.is/docs/juju/manage-charms-or-bundles#heading--update-a-charm):

```
juju refresh mattermost
```

---