Project Super
A lightweight process orchestrator for edge devices and servers — a modern, API-first alternative to Supervisor or PM2.
superd is a Rust process manager — one binary to deploy. Define programs in TOML or over REST; it handles restarts, startup order, and health checks. Manage via CLI, browser, or HTTP API.
Core Capabilities
Dependency Orchestration
Declare depends_on and start order — Super waits for upstream programs to become healthy before starting dependents.
Atomic OTA Updates
Download, verify checksum, swap artifacts, restart, and roll back automatically if health checks fail.
OTA flow →Health Checks
Scheduled TCP and HTTP probes. Failed checks mark the process unhealthy and block dependents until checks pass.
Health checks →Lifecycle Hooks
Run shell scripts at pre_start, post_start, and post_stop — prepare env, notify peers, or clean up.
Event Hooks
React to process_fatal, process_started, and other system events with local scripts — Supervisor-style listeners, API-driven.
Auto-Recovery
Supervisor-compatible autorestart, exitcodes, and startsecs — familiar semantics for migrations.
Premium Edition Commercial
API Authentication
Bearer token auth on every endpoint. Dashboard and API require login — safe to expose beyond localhost.
Authentication →RBAC
Role-based access control for operators and tenants. Limit who can start, stop, or reconfigure programs.
Access control →Cron Scheduling
Run programs on cron expressions — periodic jobs without an external scheduler or crontab.
Scheduled tasks →Cgroup Isolation
Linux cgroups v2 CPU and memory limits per program. Contain noisy neighbors on shared hosts.
Resource isolation →Webhook Notifications
Push alerts to Slack, DingTalk, Feishu, and custom URLs on process_fatal and other events.
Audit Logging
Immutable record of who changed what — API calls, config updates, and operator actions for compliance.
Operation audit →Built-in Dashboard
Overview
Process status, host CPU/RAM sparklines, and start/stop controls — served by superd, no extra web server.
Logs & Details
Live stdout/stderr, hooks, health checks, and environment in one drawer.
API-First
REST & WebSockets
Register and control programs over HTTP — the CLI uses the same endpoints. Stream logs via WebSockets.
Full API reference →curl -X POST http://127.0.0.1:9002/api/programs \
-H "Content-Type: application/json" \
-d '{
"name": "api-server",
"command": "./app",
"autostart": true,
"autorestart": "unexpected"
}'