A blazing-fast, universal production process manager built on Bun native APIs. Run, cluster, monitor, and manage any application — Node.js, Bun, Go, Python, Rust, Ruby, PHP, Java, native binaries, and shell scripts — with pure performance and zero overhead. By procboss.com.
ProcBoss is free and open-source. If it saves you time, star it on GitHub, open issues, or send pull requests.
- Universal runtimes — auto-detected: Node.js, Bun, Go, Python, Rust, Ruby, PHP, Java JARs, shell scripts, compiled binaries.
- Cluster mode — N instances, per-worker env, automatic ports, zero-downtime rolling reloads.
- Namespaces — group processes (
--namespace my-app) and operate on the group:pboss restart my-app,pboss delete my-app(confirmed;--forceskips). - Foreground mode —
--no-daemonblocks as PID 1, for Docker and Kubernetes. - Web dashboard — live WebSocket updates, CPU/memory charts, process controls, log viewer. Zero dependencies.
- Prometheus metrics — dedicated
/metricsendpoint on :9616. - Logs — automatic capture, size-based rotation, retention, gzip.
- Health checks, cron restarts, file watching — self-healing processes.
- Standalone cron jobs — friendly schedules (
everyday@9:11,on-date@24-10-2026-23:10), no managed process required, persists across reboots. - Persistence (default on) — process list saved after every change; the per-user boot service (systemd / launchd / Task Scheduler) is installed automatically — apps survive restarts and reboots.
- Tiny footprint — one daemon, <50ms start, ~12MB RAM.
Install and compile the native standalone pboss executable directly on your device — no root required. The installer puts the binary in ~/.local/bin and, when that directory is not on your PATH, adds it to your shell profile (~/.bashrc / ~/.zshrc) automatically — no manual edits:
Linux / macOS:
curl -fsSL https://procboss.com/install.sh | bash(Running the installer as root still works and installs system-wide to /usr/local/bin — but sudo is never required.)
Windows (PowerShell):
powershell -c "irm https://procboss.com/install.ps1 | iex"(No Administrator needed — installs per-user to %LOCALAPPDATA%\pboss. An elevated shell installs machine-wide instead.)
Windows (Command Prompt):
curl -fsSL https://procboss.com/install.cmd | cmdbun add -g pbossNo sudo needed: the boot service pboss installs is a per-user systemd unit (~/.config/systemd/user), so a user-local install is the recommended setup.
pboss --versionStart a process:
pboss start app.tsWith no target, pboss start auto-detects a config file in the current directory — ecosystem.config.{json,js,ts} > pboss.config.* > bm2.config.* > pm2.config.*, first match wins:
pboss startStart with a name, 4 instances, and a base port:
pboss start app.ts --name my-api --instances 4 --port 3000Group processes into a namespace and manage them as one unit:
pboss start web.ts --name web --namespace my-app
pboss start worker.ts --name worker --namespace my-app
pboss restart my-app # the whole group at once
pboss stop my-app
pboss start my-app # resume every stopped memberList all processes:
pboss list┌────┬──────────┬──────────┬──────┬───────┬──────────┬──────────┬──────────┐
│ ID │ Name │ Status │ PID │ CPU │ Memory │ Restarts │ Uptime │
├────┼──────────┼──────────┼──────┼───────┼──────────┼──────────┼──────────┤
│ 0 │ my-api-0 │ online │ 4521 │ 0.3% │ 42.1 MB │ 0 │ 5m 23s │
│ 1 │ my-api-1 │ online │ 4522 │ 0.2% │ 39.8 MB │ 0 │ 5m 23s │
│ 2 │ my-api-2 │ online │ 4523 │ 0.4% │ 41.3 MB │ 0 │ 5m 23s │
│ 3 │ my-api-3 │ online │ 4524 │ 0.1% │ 40.5 MB │ 0 │ 5m 23s │
└────┴──────────┴──────────┴──────┴───────┴──────────┴──────────┴──────────┘
pboss upgrade self-updates through the channel that installed it (installer, npm, brew, snap) — one machine, one CLI. The installer downloads the exact version the command announces (pinned against the npm registry), and the command then verifies pboss --version on your PATH actually reports it:
pboss upgrade --check # see current → latest, the detected channel, and the exact command
pboss upgrade # do it (adds --channel <x> to repair a misdetected channel)The full documentation lives at docs.procboss.com.
| Popular sections | |
|---|---|
| Quick Start | First steps, list --live, dashboards |
| CLI Reference | Every command with flags and examples |
| Docker & Containers | Foreground mode, Dockerfiles, Compose, K8s |
| Configuration | Ecosystem files and process options |
| Programmatic API | Zero-ceremony API, events, ProcessManager |
| ProcBoss Cloud | Device-code login, fleet view, the agent protocol |
| Troubleshooting | Daemon issues, restarts, port conflicts |
GPL-3.0-only — see LICENSE.