feat: add lidarr_dev stack and update README templates

This commit is contained in:
2026-07-02 21:08:11 -07:00
parent 09e133cec2
commit d3b7ac59fd
5 changed files with 131 additions and 21 deletions
+8 -21
View File
@@ -2,36 +2,23 @@
## Stack conventions
- Every stack has exactly 3 files: `compose.yaml` (or `docker-compose.yml`), `sample.env`, `README.md`
- Every stack has at least 3 files: `compose.yaml` (dockhand style), `sample.env`, `README.md`
- `_dev` = experimental, `_notes` = docs/minimal examples, no suffix = production-ready
- Always references an external `proxy` network (`docker network create proxy` once)
- Volumes use `${VOL_PATH:-/data}` as the base path
- Timezone defaults to `America/Vancouver`
- Timezone defaults to `America/Vancouver`, but only include if the container requires it.
- Restart policy, image tag, and port are configurable via env vars with sensible defaults
- `deploy.bash` at root emulates Dockhand CLI for local testing (uses `fzf`)
- New stacks: copy from `_docs/template-compose.md` and `_docs/template-readme.md`
- Compose section order: `image``restart``volumes``environment``ports``networks``depends_on``healthcheck``labels``command``user`
## Test a single stack
```sh
# From the stack directory:
docker compose --env-file sample.env up -d
```
Note: `deploy.bash` only looks for `compose.yaml`, not `docker-compose.yml`.
## Environment loading
`--env-file` supports multiple files, applied in order (last wins):
```sh
docker compose --env-file sample.env --env-file /data/test.env up -d
- README section order: `Overview``Getting Started``Docker Run``Project Details``Environment Variable Notes``Volume Notes``Network Notes``Additional Notes / Gotchas``Dockhand Stack, Deploy from Git`
- Every compose file must declare the external `proxy` network at the root level:
```yaml
networks:
proxy:
external: true
```
## No CI/CD, no dependency management
This is a Docker Compose file collection, not a code project. No tests, no build tools, no lockfiles.
## OpenCode
The `opencode/` stack runs OpenCode with a local ollama backend. Config is at `opencode/config/config.json`. Requires `ollama/` stack to be running and `OPENCODE_SERVER_PASSWORD` to be set.