# BBB (BigBlueButton) — Ubuntu container (koopa)

CachyOS exception: BBB packages and `bbb-install` target **Ubuntu**. Front stub image is Ubuntu 24.04.

| Item | Value |
|------|--------|
| Stack | BigBlueButton (front stub → core later) |
| Image | `localhost/koopa-bbb-front:ubuntu` (`FROM docker.io/library/ubuntu:24.04`) |
| Live dir | `/home/hernani/koopa-bbb/` |
| Container | `koopa-bbb-front` |
| Host port | **9032** |
| Public site | `bbb.hacktivism.ch` |

## Phases

1. **Front stub (this tree)** — nginx placeholder on `:9032` so Caddy + DNS can land.
2. **Greenlight (optional)** — Rails UI talking to a real BBB API; still Ubuntu-based images.
3. **BBB core** — FreeSWITCH / mediasoup / akka-apps. Prefer official Ubuntu install (`bbb-install.sh`) on a dedicated Ubuntu host/VM, or a known multi-container BBB compose. Not CachyOS.

Media UDP/TCP and TURN are documented when core is chosen — not in this stub.

## Build + up (koopa)

```bash
bash /path/to/koopa-admin-log/scripts/bbb/build.sh
mkdir -p ~/koopa-bbb && cp -a /path/to/koopa-admin-log/configs/bbb/{compose.yml,Containerfile,entrypoint.sh} ~/koopa-bbb/
cd ~/koopa-bbb && HOST_PORT=9032 podman-compose up -d
```

## Caddy

```bash
sudo bash /path/to/koopa-admin-log/scripts/caddy/caddy-apply.sh \
  --snippet /path/to/koopa-admin-log/configs/caddy/bbb.hacktivism.ch.caddy \
  --site bbb.hacktivism.ch --port 9032 --label bbb
```

DNS + VeciGate for the hostname after apply Freigabe.