1.8 KiB
Running CI locally
Install Act and ensure Docker is running, then use:
pnpm ci:act:fast
pnpm ci:act:docker
pnpm ci:act:all
pnpm ci:act:cleanup
fast runs the quality gate. docker and all run the gate followed by the single container build, E2E suite, and memory regression test. cleanup validates the manual cleanup path without calling GitHub. The wrapper supports regular clones and Git worktrees, including non-default Docker contexts. Linux dependencies are kept in Docker volumes instead of overwriting host node_modules. The first run downloads the Act runner and Playwright browser dependencies.
Remote caching is optional locally. Copy .github/act/.secrets.example to .github/act/.secrets, populate it with rotated credentials, and run with:
ACT_SECRET_FILE=.github/act/.secrets pnpm ci:act:all
Act never publishes or deletes GHCR images. The secret file is ignored by Git.
PR preview images
Successful non-draft pull requests from this repository publish an amd64 image:
docker pull ghcr.io/homarr-labs/homarr-test:pr-<number>
The tag is replaced when the pull request is updated and deleted when it closes. Production Homarr images remain the supported multi-architecture releases. The homarr-test package must be configured as public in GHCR for unauthenticated testers.
Dokploy preview cache
Keep needs-demo as the Dokploy preview label. Under the application's Preview Build-time Secrets, configure TURBO_API, TURBO_TEAM, TURBO_TOKEN, and TURBO_REMOTE_CACHE_SIGNATURE_KEY. Dokploy passes these to the Dockerfile as BuildKit secrets. Do not configure the token or signature key as Docker build arguments.
Rotate any credentials that have appeared in chat, logs, or committed configuration before enabling the cache.