cadcad-discourse-forum/README.md

cadCAD Community Discourse Forum

Self-hosted Discourse forum for the cadCAD community.

• Temp URL: https://cadcad-forum.jeffemmett.com
• Final URL: https://community.cadcad.org (pending DNS coordination)
• Server: Netcup RS 8000 at /opt/discourse/
• Memory: 2GB container limit + 2GB swap

Quick Reference

ssh netcup
cd /opt/discourse

./launcher logs app        # View logs
./launcher restart app     # Restart
./launcher rebuild app     # Rebuild (after config changes)
./launcher enter app       # Shell into container
./launcher stop app        # Stop

After any rebuild, reconnect to Traefik:

bash scripts/post-rebuild.sh

Initial Setup

1. Run scripts/install.sh on Netcup (or see SPEC.md for manual steps)
2. Add cadcad-forum.jeffemmett.com to Cloudflare tunnel
3. Create admin account: ./launcher enter app → rake admin:create

Import Existing Forum Data

1. Get .tar.gz backup from existing community.cadcad.org admin panel (/admin/backups)
2. Upload to Netcup: scp backup.tar.gz netcup:/tmp/
3. Run: bash scripts/restore-backup.sh /tmp/backup.tar.gz

Switch to community.cadcad.org

1. Edit containers/app.yml: update DISCOURSE_HOSTNAME and Traefik Host() rule
2. ./launcher rebuild app && bash scripts/post-rebuild.sh
3. Add community.cadcad.org to Cloudflare tunnel
4. Coordinate DNS: CNAME community.cadcad.org → tunnel UUID .cfargotunnel.com

Configure Email (SMTP)

Uncomment and fill in the SMTP section in containers/app.yml, then rebuild.