Skip to content

hzbd/super

Repository files navigation

🦸 Project Super

The API-First, Lightweight Process Orchestrator for the Edge.

Super is a modern replacement for tools like Supervisor or PM2, built with Rust. It is designed for edge computing, IoT devices, and high-performance servers.

Public beta

Super 1.x is feature-complete and in active hardening. The core process-management paths (start/stop/restart, auto-recovery, health checks, OTA rollback) are covered by integration tests and run in the maintainers' own deployments. We recommend it for staging and non-critical workloads today; see below for what we require before calling it production-ready (GA).

  • OSS core (superd + super) is free under MIT — install and try anytime.
  • Super Pro plugins (Dashboard UI, API auth/RBAC/audit, notifications, Linux cgroup isolation) are available with a free 1-year license during the beta. No payment required.

Request a free Pro trial: open a GitHub Issue (use the Pro trial request template). Include a contact email — we will send the license key and plugin package to that address.

Documentation: https://super.docs.sconts.com/docs/

Core Features

  • Single binary — Rust superd process manager; TOML or REST config; CLI and HTTP API (Dashboard via optional ui plugin)
  • Declarative orchestration — stacks, dependencies, health checks
  • Lifecycle hookspre_start, post_start, post_stop, and global event hooks
  • Observability — WebSocket logs, historical logs API, system metrics
  • Auto-recovery — Supervisor-compatible autorestart, exitcodes, startsecs

Licensed under the MIT License. Optional licensed plugins (.so / .dylib under $SUPER_ROOT/plugins/) add API auth, RBAC, notifications, and cgroup limits — same superd binary, no separate commercial build. Compare editions in the feature matrix.

Quick Start

Install script (Linux / macOS / FreeBSD)

curl -fsSL https://raw.githubusercontent.com/hzbd/super/master/install.sh | sh

Installs superd and super into /usr/local/bin (or ~/.local/bin when not writable), verifying the SHA-256 checksum of the release archive. Options: --version X.Y.Z, --prefix DIR, --no-sudo.

Docker

Docker image (linux/amd64):

docker pull containerpi/super:latest
docker run --rm -p 9002:9002 containerpi/super:latest

With a custom config directory:

docker run --rm -p 9002:9002 -v ./dockerbuild/conf:/app/super/conf containerpi/super:latest

From source

git clone https://github.com/hzbd/super.git && cd super
make build
./target/release/superd

CLI

super add --name redis --autostart /usr/bin/redis-server
super list
super logs <id> --tail

Diagnose a setup (config, daemon connectivity, license) in one shot:

super doctor

Toward GA

We will call Super production-ready (GA) when the following are true. If you rely on Super today, this is the contract we are working against — feedback on any of these is the most valuable contribution right now.

  • Stability — no known panic paths in the daemon on malformed config or API input; graceful degradation when a plugin fails.
  • Upgrade safety — OTA updates are transactional (backup → verify → commit/rollback) and covered by integration tests.
  • Security defaults — fail-closed network binding, signed-plugin verification, and no secrets in API/CLI output; cargo audit clean on release branches.
  • Operabilitysuper doctor diagnoses a deployment end-to-end; logs and metrics are sufficient to triage without a debugger.
  • API stability — the REST API and the plugin C ABI (PLUGIN_API_VERSION) are versioned; breaking changes ship only with a major bump and migration notes.

Track progress in the changelog.

Documentation

Topic Link
Getting started Docs
Configuration Config reference
API API reference
Changelog v1.2.1
Editions / Pro plugins Feature matrix

Contributing

See CONTRIBUTING.md. Security issues: SECURITY.md.

About

The API-First, Lightweight Process Orchestrator for the Edge.

Topics

Resources

License

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors