cadcad-discourse-forum/README.md

50 lines
1.5 KiB
Markdown

# 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
```bash
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
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.