Align quickstart first-start section with profile bootstrap

Replace legacy download-bonsai-only steps with apply-profile and
bootstrap-stack; note mini CPU vs mid/gaming Vulkan.
This commit is contained in:
tim 2026-07-22 19:03:36 -07:00
parent 7982d43394
commit 84a0945b10

View file

@ -64,23 +64,26 @@ docker compose up -d # if compose/images changed
Ansible can also refresh code: `ansible-playbook site.yml -K --tags stack,deploy` (runs `git fetch` + checkout).
Local-only (not in git): `.env`, `config/`, `models/**/*.gguf`, `wireguard/wg0.conf`.
**Before first full stack start** (on ser5):
**Before first full stack start** (on ser5) — same as profile bootstrap:
```bash
ssh tim@192.168.8.123
# new login so docker/video/render groups apply
cd /opt/stack
# wireguard/wg0.conf must exist (no IPv6; Endpoint = IP not hostname)
./scripts/download-bonsai-model.sh # ~7.2 GB GGUF
docker compose build bonsai
docker compose up -d
# or: sudo systemctl enable --now arr-stack
git pull
# wireguard/wg0.conf must exist (no IPv6; Endpoint = IP not hostname; # EndpointHost = …)
./scripts/apply-profile.sh mini # or mid | gaming
./scripts/bootstrap-stack.sh # models + build + compose up ALL services
# or step-by-step:
# ./scripts/download-models.sh
# docker compose build bonsai && docker compose up -d
sudo systemctl enable --now arr-stack # optional: start stack on boot
docker compose ps
```
**Compose GPU notes**
**Compose GPU notes (mid / gaming)**
- Keep `devices`/`group_add` only in `docker-compose.override.yml` (not also in the main file).
- Use **numeric GIDs** for `group_add`, not names (`video`/`render` fail inside the image). Or omit `group_add` if `/dev/dri` is mode `0666`.
- **mini** uses CPU (`BONSAI_NGL=0`) — no GPU devices required.
Re-run playbook anytime: `ansible-playbook site.yml -K`