Discourse Setup Troubleshooting

Written by Isaac

Recently I tried looking into getting Discourse setup on a homelab server. Unfortunately, the project has a heavily customized installation / launcher script, resulting in this venture spanning roughly a week.

I did eventually manage to get it setup behind Cloudflare, and for posterity sake figured I'd detail the troubleshooting I had to go through:

Launcher Refusing to Progress Past Port Check

Launch the setup script with --skip-connection-test (found here).

Website Not Accessible Through Tunnel

Ensure the Rocket Loader is disabled.

Appending - "templates/cloudflare.template.yml"1 to the templates breaks it

Ensure that you've appended that line; the order of the templates does matter.

MailJet Suspending / Preventing Emails

I couldn't figure this out, but Brevo worked flawlessly.


  1. Important to ensure client IPs passthrough.

    ↩︎