# Discourse charm

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


2026

## Pages

- [Discourse Operator](https://canonical.com/juju/docs/discourse-k8s-charm/latest/index.html.md): Learn how to deploy, configure and operate the Discourse charm using Juju.
- [Deploy the Discourse charm for the first time](https://canonical.com/juju/docs/discourse-k8s-charm/latest/tutorial/index.html.md): In this tutorial, we’ll go through each step of the process to get a basic Discourse deployment.
- [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.
- [Reference](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/index.html.md): Technical reference documentation for the Discourse charm, including actions, configurations, and architecture.
- [Actions](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/actions/index.html.md): See Actions.
- [Configurations](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/configurations/index.html.md): See Configurations.
- [Plugins](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/plugins/index.html.md): By default, the following Discourse plugins are installed with the latest version from source.
- [Integrations](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/integrations/index.html.md): *Interface*: `pgsql`
- [External access required by the Charm](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/external-access/index.html.md): Depending on the configuration of the charm, the following external accesses are needed:
- [Charm architecture](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/charm-architecture/index.html.md): At its core, Discourse is a Ruby on Rails application that integrates with PostgreSQL and Redis.
- [Versioning](https://canonical.com/juju/docs/discourse-k8s-charm/latest/reference/versioning/index.html.md): The Discourse charm has transitioned from semantic versioning to calendar-based versioning to align ...
- [Explanation](https://canonical.com/juju/docs/discourse-k8s-charm/latest/explanation/index.html.md): Explanations of key concepts for the Discourse charm.
- [Security](https://canonical.com/juju/docs/discourse-k8s-charm/latest/explanation/security/index.html.md): This document explains the possible security risks in the Discourse charm and best practices to avoi...
- [Changelog](https://canonical.com/juju/docs/discourse-k8s-charm/latest/changelog/index.html.md): - Update Markdown plugin, fixing deprecation warning of .es6 file extension.