docs: explain hardcoded host and Coolify network UUID

Coolify does not interpolate ${...} inside the labels: block, so the
two strings tying this template to its specific Coolify resource cannot
currently be variables. Document where they appear and how to swap
them when redeploying as a new resource.
This commit is contained in:
Julien Calixte
2026-06-01 21:27:19 +02:00
parent 78fe916c2f
commit 0ac46ecadb

View File

@@ -32,6 +32,17 @@ If the init logs show CORS errors, you can re-trigger only that step by redeploy
Wildcard origin (`*`) with `credentials = false` — the only browser-spec-legal combination with a wildcard. For credentialed auth from the browser, edit the `put_config cors origins`/`credentials` lines in `docker-compose.yml`. Wildcard origin (`*`) with `credentials = false` — the only browser-spec-legal combination with a wildcard. For credentialed auth from the browser, edit the `put_config cors origins`/`credentials` lines in `docker-compose.yml`.
## Hardcoded values (cloning to another Coolify resource)
Two strings in `docker-compose.yml` are pinned to this specific Coolify deployment and must be updated if you redeploy as a new resource:
- The host in `traefik.http.routers.coolcouch.rule=Host(`couch.apoena.dev`)`
- The per-resource Coolify network name, appearing twice: `traefik.docker.network=lvw8efvnvsxduodrkg68zul3` and `networks.coolify.name: lvw8efvnvsxduodrkg68zul3`
They're hardcoded because Coolify does not interpolate `${...}` inside the `labels:` block (it does inside `environment:` and `networks.<name>.name:`). The network UUID matches `COOLIFY_RESOURCE_UUID` for the resource — find it in Coolify's UI or in `docker network ls` after first deploy.
A `sed` swap before push, or a Coolify "Custom Build Command" running `sed -i` over the file, is the simplest way to keep this template portable.
## Files ## Files
- `docker-compose.yml` — services, volume, Traefik labels, init sidecar - `docker-compose.yml` — services, volume, Traefik labels, init sidecar