This page is the central place where all information needed to maintain the forum are stored.
Here is some general, non-sensitive information about our instance. When setting up the forum, we followed the official installation guide. Posts from the old forum were not imported due to time restrictions of the voluntary administrators.
- Installation type: docker
- Installation directory: /var/discourse
- App configuration: /var/discourse/containers/app.yml
- Version: tests-passed (planned to switch to stable)
- SSL: Let’s Encrypt
Upgrading the forum is quite simple. It is always announced at least 15 minutes beforehand in a dedicated maintenance log topic in the forum. Upgrades are planned to be done every one to two weeks. If you feel like there was an important update to Discourse which should get deployed earlier, feel free to suggest that in the topic mentioned above.
For administrators, this is the common way on how to upgrade the forum:
- Announce the update at least 15 minutes beforehand in the maintenance log topic
- Make a backup of the forum
- Wait until the backup finished and download it (you’ll get a link by mail)
- Go to the upgrade section
- Upgrade (the different parts of) the forum, e.g. sometimes docker_manager has available updates which need to happen before discourse
- Report that all updates were successful in the maintenance log topic
In case something goes wrong with the forum, stay calm, you’re likely not the first to be affected by this. Mostly a quick internet search gives you detailed instructions on how to fix a problem. There is also a really good guide called Advanced Troubleshooting with Docker on Discourse’s forum. In the past, the following instructions were helpful:
Manually downloading backups
If you ever have problems with Discourse not starting, you can always download backups manually over SSH to ensure no user data is lost. Discourse creates backups itself once a week and stores them at the following path: /var/discourse/shared/standalone/backups/default
Rebuilding the container
cd /var/discourse git pull ./launcher rebuild app