[[PageOutline]]

= Discourse Admin =

We are running an instance of [https://www.discourse.org/ discourse] on septima. User facing documentation: [wiki:comment].

It was installed by following the [https://github.com/discourse/discourse/blob/master/docs/INSTALL-cloud.md discourse install directions], which essentially automate the installation of a docker app.

It's not ideal - since it pulls images from docker's repo, however, the complexity of this app makes a manual installation seem overwhelming.

The x509 certificate is automatically handled by letsencrypt.

The email is relayed via bulk.mayfirst.org.

We login via [https://meta.discourse.org/t/official-single-sign-on-for-discourse-sso/13045 Discourse's single sign on implementation] (which users our control panel to authenticate users).

== Logging in ==

There is a `discourse-admin` user with credentials in [wiki:keyringer keyringer] tied to `discourse@mayfirst.org` email address.

== Creating Private groups ==

By default, posts are public. If you want to create a private group for a member, take these steps:

 * Create a group and assign the group an owner
 * Create a category and configure so that it is only viewable by members of the group you created
 * Instruct members to always post topics to their private category
   
== Replies by email ==

You can reply by email, thanks to the discourse-replies user account that is [https://meta.discourse.org/t/set-up-reply-via-email-support-e-mail/14003 configured according to these directions]. See #13429.

== Upgrading ==

You can upgrade from within Discourse (while logged in as the admin) which rebuilds the docker application. The email address associated with the discourse admin user gets an email notification when new versions are available.

== Backups ==

Backups are configured within Discourse to run once a day and backup to `/var/discourse/shared/standalone/backups/default/` - which is configured by backupninja to be backed up to our backup servers.