Discourse is the software running this forum. This document will guide you through installing a low-maintenance, standalone instance of Discourse for your site.
The following post is a wiki: please get acquainted with the recommendations before jumping in.
After following this runbook, you will have a running instance of Discourse for yourself.
Overview
Installing Discourse
Setting up email
Configuration tips
Low Maintenance
Beyond Standalone Discourse
Installing Discourse
Discourse has a thorough installation guide with Docker which we shall break down to the minimum: if you encounter an issue, please refer to that guide.
Domain setup
We recommend using Gandi LiveDNS and Gandi Mail services for the simplest setup possible.
1. Obtain a domain on Gandi
Gandi domains come with LiveDNS (instant activation of records) and the Gandi Mail service that provides infinite forwarding addresses, which will be useful for our email setup.
If you use another domain and email provider, adapt your setup!
Setting up email
TBC
Configuration tips
TBC
Low maintenance
By default, discourse_docker follows the tests-passed branch, which is updated every day. This brings you the cutting edge features and fixes. But you are required to upgrade more often.
Instead you can follow the stable branch that incorporates critical fixes and follows stable releases. In your container YAML file, edit the params from:
params: │
## Which Git revision should this container use? (default: tests-passed) │
version: tests-passed
to follow stable:
params: │
## Which Git revision should this container use? (default: tests-passed) │
version: stable
Picking up changes
Now run:
# cd /var/discourse
# ./launcher rebuild standalone
Beyond Standalone Discourse
This setup has the advantage of simplicity: you can be up and running within an hour or less. But it does not scale to multiple servers, or multiple domains. Such configuration is less widely documented, but you can follow the Multisite configuration with Docker guide for a starter.
As Discourse created their own intricate way of using Docker, it’s a bit complicated to reproduce a classical docker and docker-compose setup, which @unteem is working on:
My plan was actually to get this docker-compose Discourse thing running, and I realized you made a release recently. I certainly would recommend the official Discourse setup since it’s the one that is supported and provides one-click upgrades. Nevertheless I’m planning to move on to your setup, and that’s another step. Thank you for keeping it up-to-date. Maybe you can start a new topic explaining your setup, @unteem?
I commented out Collude since I’ve had issues with it (losing edits) and we use CodiMD anyway.
Voting is not the way we want to do things here (and we already have and on Gitlab), and we do not use Github… Moderator extension is pending some fixes…