# Discourse charm

> This is the documentation for the Discourse charm, a Juju charm that deploys and manages Discourse on Kubernetes.


2026

## Pages in this subsection

- [How-to guides](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/index.html.md): How-to guides for operating the Discourse charm, including basic operations, upgrades, and deployments.
- [How to configure the hostname](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/configure-hostname/index.html.md): This guide provides instructions for configuring the external hostname of the Discourse charm.
- [How to configure the container](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/configure-container/index.html.md): This charm exposes several configurations to tweak the behaviour of Discourse. These can by changes ...
- [How to access the Rails console](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/access--the-rails-console/index.html.md): Ideally, the Discourse charm should be handled by interacting with Juju, and everything that can be ...
- [How to configure S3](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/configure-s3/index.html.md): An S3 bucket can be leveraged to serve the static resources packaged by Discourse, potentially impro...
- [How to configure SMTP](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/configure-smtp/index.html.md): To configure Discourse’s SMTP you’ll have to set the following configuration options with the approp...
- [How to configure SAML](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/configure-saml/index.html.md): To configure Discourse’s SAML integration you’ll have to set the following configuration options wit...
- [How to back up and restore Discourse](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/backup-and-restore/index.html.md): This document shows how to back up and restore Discourse.
- [How to upgrade](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/upgrade/index.html.md): Upgrades are done just by running the `juju refresh` subcommand. Juju, Kubernetes, and Discourse the...
- [How to contribute](https://canonical.com/juju/docs/discourse-k8s-charm/latest/how-to/contribute/index.html.md): Familiarize yourself with contributing to the Discourse charm documentation.

## Optional

- [Top-level llms.txt](https://canonical.com/juju/docs/discourse-k8s-charm/latest/llms.txt): Complete documentation index.