A lightweight workload orchestrator with declarative deployments — single binary, no control plane.
Ring is an alternative to Kubernetes and Docker Swarm that ships only the essentials: a REST API, a scheduler, and a state engine that reconciles desired vs. current state. No etcd, no operators, no helm charts.
- Declarative YAML/JSON deployments with state diffing
- Replicas, rolling updates, and automatic restarts
- Health checks (TCP, HTTP, command) with self-healing
- Secrets, volumes, labels, resource limits (CPU/memory)
- Multi-namespace isolation and network segmentation
- User management with role-based access
- Docker and Cloud Hypervisor runtimes
Ring does not handle load balancing — pair it with Traefik, Caddy, or nginx.
cargo build --release
ring init
ring server start
ring login --username admin --password changeme
ring apply -f examples/nginx.yamlSee Install and run for prerequisites and Your first deployment for a full walkthrough.
- Documentation index — start here
- Tutorials — install and run, first deployment
- How-to guides — health checks, rolling updates, secrets, networking, jobs
- Concepts — architecture, reconciliation, runtimes
- Reference — manifest schema, CLI commands, HTTP API, config
See LICENSE.