A focused deployment workspace for Coolify: scan projects, inspect deployment history, and read live logs without clicking through Coolify's nested UI.
Requirements: Node.js 20 or 22, pnpm, and a Coolify API token.
git clone https://github.com/sandwichfarm/cooldash.git
cd cooldash
pnpm install
cp .env.example .env.localEdit .env.local:
COOLIFY_API_URL=https://coolify.example.com/api/v1
COOLIFY_API_TOKEN=replace-with-coolify-api-token
COOLIFY_API_TIMEOUT_MS=10000Run it:
pnpm devOpen the Vite URL, usually http://localhost:5173. A working setup shows your
Coolify applications, deployment history, and selected deployment log.
- One dense workspace for Coolify projects, deployments, and logs.
- Search, status filtering, grouping, persisted preferences, and light/dark mode.
- Live polling with pause/resume, retry state, and stale-response protection.
- Explainable status provenance when application status lags deployment reality.
- Selected-application redeploy with explicit confirmation.
- A same-origin server proxy so
COOLIFY_API_TOKENnever reaches the browser.
| Need | Read |
|---|---|
| Environment variables and token setup | Configuration |
| Coolify Dockerfile deployment | Deployment |
| Token boundary, scans, and mutation limits | Security |
| Startup/API/build failures | Troubleshooting |
| Commands, tests, repo layout, contributing | Development |
cooldash is read-mostly. The browser talks only to /api/coolify/*; the
server proxy owns the Coolify bearer token. The only shipped mutation is a
selected-application normal redeploy, guarded by confirmation and active-
deployment checks. Cancel, rollback, restart, force rebuild, tag/PR deploy, and
environment editing are not implemented.
MIT — see LICENSE.