systemg 0.61.2

An agent-friendly general process composer.
Documentation
---
title: Philosophy
---

# Philosophy

systemg exists to run a handful of related processes as one unit — with dependency ordering, restarts, and privilege dropping — without asking you to become a systemd expert or hand your app to a container runtime.

## What we optimize for

**Legible configuration.** One YAML file describes your services, their order, and how they're confined. It reads like what it does. No unit-file dialect, no generated indirection, no "where is this actually configured."

**One binary, no runtime.** systemg is a single self-contained binary. There's nothing to install alongside it, nothing to keep in sync, and the same binary and config run on a laptop and in production. Dev/prod parity is the default, not a project.

**Correct process lifecycle.** Services start in dependency order and are supervised for real: unsuccessful exits restart with backoff, process-group teardown does not orphan children, and persisted state makes ownership recoverable after a supervisor restart.

**Secure because it's the default, not because you configured it.** A service that drops to another user starts from a clean environment with reset supplementary groups and trimmed capabilities — you don't have to remember to ask. The [control socket](security) is authenticated and owner-only. Least privilege is the path of least resistance.

**Honest about its boundaries.** When a feature isn't implemented, systemg says so and warns — it never silently pretends a seccomp profile or namespace is in effect. The [trust model](security) is written down, and the code is audited against it.

## What we're not

systemg is not a container runtime, an orchestrator, or a replacement for PID 1 on a full OS. It's the layer between "a shell script with `&`" and "stand up Kubernetes" — the right tool when you have a few services that belong together and you want them supervised, ordered, and confined, on one machine.

## See also

- [Introduction](intro) — what systemg does
- [Security](security) — trust model and hardening
- [Configuration](how-it-works/configuration) — define your system