buildfyio

One command from nothing to a running dashboard.

npx buildfyio

That's it. On a clean machine with Docker Desktop installed, this pulls Buildfyio Local (Postgres + Redis + API + worker + web), starts it, and opens the dashboard at http://localhost:3000.

Second run is instant — images are cached, data is preserved in ~/.buildfyio/local/.

Commands

npx buildfyio            # start + open dashboard
npx buildfyio stop       # stop everything (data preserved)
npx buildfyio --help
npx buildfyio --version

Requirements

• Docker Desktop or a Linux daemon with the socket at /var/run/docker.sock.
• Node ≥ 20.11 (only to run the launcher itself; the actual stack runs in containers).

Data location

~/.buildfyio/local/ — compose.yaml, secrets, per-run Docker volumes. Delete the directory to reset everything.

What runs

Five containers. Uptime is your Docker Desktop's uptime.

• postgres:16-alpine
• redis:7-alpine
• ghcr.io/talyaglobal/kolaydeploy-api:latest
• ghcr.io/talyaglobal/kolaydeploy-worker:latest (Docker driver mode)
• ghcr.io/talyaglobal/kolaydeploy-web:latest

Nothing phones home; nothing runs on your host except the docker subprocess. When you're ready for a public URL, https://buildfyio.com/dashboard/import graduates a local project to hosted in a couple of clicks.

License

MIT.