diff --git a/quickstart.md b/quickstart.md index 1d3fb43..c0ddc23 100644 --- a/quickstart.md +++ b/quickstart.md @@ -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`