# Homelab sidecar services

Version-controlled copies of the NAS-side scripts that support this
SillyTavern deployment. The deployed copies live on the unraid NAS; when
changing one, update both (scp to the NAS path + commit here).

| File | Deployed at | Purpose |
|---|---|---|
| `whisper-lazy-proxy.py` | `/mnt/user/appdata/whisper-lazy/proxy.py` (container `whisper-lazy`, :10300) | Wyoming lazy proxy: answers HA availability checks from cache, starts `faster-whisper` on demand, stops it after 15 min idle (frees GPU VRAM). |
| `unraid/my-sillytavern.xml` | `/boot/config/plugins/dockerMan/templates-user/my-sillytavern.xml` | Unraid template for the GitGudLab `:latest` image and persistent config/data/plugin mounts. |
| `unraid/bootstrap-sillytavern.sh` | `/boot/config/bootstrap-sillytavern.sh` | Recovery bootstrap used when the container or DockerMan template is absent. |
| `unraid/redeploy-sillytavern.sh` | `/boot/config/redeploy-sillytavern.sh` | Recreates the container through Unraid's own updater so template and update-state bookkeeping stay authoritative. |
| `unraid/registry-autoupdate.sh` | `/boot/config/registry-autoupdate.sh` | Polls the configured container tags and invokes their Unraid-managed redeploy scripts when an image changes. |

## SillyTavern image deployment

The NAS now runs the official stable release image,
`ghcr.io/sillytavern/sillytavern:latest`. permissionBRICK features live in
persistent public browser/server extensions instead of a custom image.

On Unraid, Community Applications Auto Update has `sillytavern` enabled. A
shared registry poller additionally checks the official tag every two minutes
and invokes `redeploy-sillytavern.sh` when its image ID changes. Do not point
the DockerMan template at a different image while leaving that poller enabled:
the poller and template would otherwise continually disagree and recreate the
container.

The persistent UI extensions live below
`data/default-user/extensions` and are discovered through the data mount. Do
not restore the obsolete `/home/node/app/public/scripts/extensions/third-party`
bind mount. `config.yaml` is a single-file bind mounted at
`/home/node/app/config`; plugins remain mounted at `/home/node/app/plugins`.

Related: the RunPod worker image (ComfyUI + custom nodes + boot-time model
downloader) is built from github.com/permissionBRICK/comfyui-runpod-worker
(private repo, public GHCR package; mirrored on this GitGudLab).

The RunPod lazy proxy, CLI, tests, container image, and Unraid template moved to
the public `permissionBRICK/ST-RunPodProxy` repository. Image Provider
Extensions links to that service as its optional RunPod backend. Its published
container is also checked by `registry-autoupdate.sh` and redeployed through
DockerMan when `latest` changes.