Files
dockge-image-update-checker/.codex/project.md
MrSphay ae098261ef
Some checks failed
Build / test (push) Successful in 11s
Build / container (push) Failing after 23s
Use registry token for image publishing
2026-05-14 17:48:16 +02:00

40 lines
1.1 KiB
Markdown

# Project
Name: dockge-image-update-checker
Description: Companion service that checks Dockge stack images for newer registry digests.
Stack: Node.js 20+, Docker, Docker Compose
## Commands
```bash
npm test
npm run build
npm run check
```
## Runtime
Environment variables:
- `STACKS_DIR`: Dockge stacks directory. Defaults to `/opt/stacks`.
- `PORT`: HTTP port. Defaults to `8080`.
- `CHECK_INTERVAL_SECONDS`: background refresh interval. Defaults to `3600`.
- `DOCKER_SOCKET`: Docker socket path. Defaults to `/var/run/docker.sock`.
- `DOCKER_HOST`: optional `tcp://host:port` Docker API endpoint.
## Artifact
Container image from `Dockerfile` published by Gitea Actions:
```text
git.wilkensxl.de/mrsphay/dockge-image-update-checker:latest
```
Publishing requires a repository Actions secret named `REGISTRY_TOKEN` with package write access for `MrSphay`.
## Notes
Dockge does not currently expose a stable documented plugin API. This repository is structured as a read-only companion service that can run beside Dockge and inspect the same stack directory plus Docker Engine metadata.