Setting Up Discourse: A Step-by-Step Guide and Learnings

This post will be of interest to anyone interested in how to setup discourse from both a tech and building community perspectives.

Matt Cameron

Nov 29, 2024 — 5 min read

Some prospective learnings from setting up an open-source instance of Discourse at community.influencer.tips

Deploy the platform - Save yourself a heap of time and use the DigitalOcean Discourse Marketplace to get your Discourse server running. For me, it took about 3 days of trial and error with various deploy READMEs to get to the place with everything working in the backend as expected. And no, I'm not affiliated with DigitalOcean, I just love their services. That said, I will keep researching the docker approach to deployment as that aligns more with my view of how I would like to amange Discourse.
Follow the setup instructions on DigitalOcean Discourse Marketplace - This step includes details about domain name, SMTP email server and setting up the admin account. You will need to be familar with SSHing into a the server to run the install script. Also, be patient it takes about 10 minutes for the deployment to complete.
Invite your loyal friends to help - When launching your community, you’ll want it to feel vibrant and engaging - not like an empty space. Start by sparking discussions now! Ask friends who share an interest in your topic to post questions on your forum and take the time to respond thoughtfully. This will create valuable conversations and make the community more appealing to others. When reaching out, let them know their involvement makes a real difference and that you’re still in the building phase. People love to be part of something new and meaningful - so share your vision and invite them to grow it with you. For example, checkout this post where if you visit right now you will see a discourse community forum just starting, but with one very important ingredient which is the start of community participation.
Encourage profile pictures - Ask your new community forum members to upload their profile pictures - because life is so much better when you can see someones smiling happy face.
Ask for feedback, listen and do what is important - As people start using the new platform, ask for feedback, listen, and prioritise your backlog for what to do next.
Make it all behave, look, and feel right - Finally the Discourse admin bit. As you are most likely the admin, visit the admin tab in the side menu and let's work through the options from the top.
1. Dashboard - The dashboard is presented first. Personal takeaway, it is nice to see backups, version control, modiration & security getting such a high mention on the list of admin tasks. The dashboard options consisting:
  1. General - These are a series of gauges and charts what are designed to inform you about what is happening within the Discourse community. Making sense of these will depend on what is important to you. Topics (which are the questions) and daily engaged users would be something that I personally would recommend tracking. This screen also contains current deployed version, a summary of recent updates and details about backups. More on those important considerations soon.
  2. Modiration - Next is modiration which gives you a high level birds-eye view of who is doing what. Red flags about suspicious spammy behaviour will be surfaced here.
  3. Security - Continuing the theme of keeping the space safe for all is security where you can see any suspicious logins.
  4. Reports - A collection of more Discourse management reports.
2. Users - This screen is very self explaitory. Listed down the screen in rows are all the users and across the top of the screen are different ways of looking at these users consisting:
  1. New, Staff, Suspended, Silenced and Staged Users - These options are self-explanatory.

Groups - This option shows how you or the system have group users by role or behaviour.
Send invites - This is were you can send an invite to a person to become a member of the community forum.

All site settings - There are many options listed here and I'm not going to go throught them all. The big ones are:
1. Required – This is the first tab for all the essentials, such as a name for the forum and its description. There are some legal details here, so it’s wise to review everything carefully. When making changes to fields, remember to tick the green arrow next to the field; otherwise, your input won’t be saved
2. Branding - I have been looking forward to this one. This is where all your design images will go. The first two are required as all the others if left blank will default to these. I used business logo for these. Remember to tick the green arrow to save these.
3. Basic Setup - Lots of options for customisations. For now suggesting just to go with the defaults.
4. Login - There is a very fine line between providing an open forum to build trust with the community and creating a safe space for members to share what matters most to them. If you are committed to offering a very safe environment for your members, these options, among the many others on this page, are important to consider, including:
  1. Invite only - When checked ,all new users must be explicitly invited by trusted users or staff and public registration is disabled.
  2. Login required - When checked, only members that are logged in will be able to see content. Note that disallow anonymous access will mean that Google and chatGPT will not be able to index your forum with will have a direct impact on organic SEO.
  3. Must approve users - When checked, all new users must wait for moderator or admin approval before being allowed to log in.
5. Notifications - Once again, a treasure trove of options! For now, I’m going with all the default settings and suggest that, in the interests of getting your Discourse setup running quickly, you do the same. You can always revisit and customise as needed. That said there is one field that is required and that is the first one - provide your email as required.
6. Update Discourse - For now whilst this is a work in progress I will skip this for now and provide details later.
7. Backups - For now, while this is a work in progress, I’ll skip this and provide the details later. What’s important to me is ensuring that, before making any updates, I have a reliable backup method established and tested. For now, I’ll stick with manual backups of the database. Note that this likely won’t include any content uploaded to Discourse.
8. What's new - As the name suggests a list of features that will depend on the current version of Discourse that you are using.

This post is a work in progress and I'll be sharing more soon as I continue to work through this process. The good news is that I feel like I'm about a third of a way through it.