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