orchd

Execution engine for the Orch specification. Takes parsed Orchfile JSON and turns it into running, supervised services.

Orchfile → orch parse (JSON) → Runtime (ExecSet) → Platform (native artifacts)

Runtime produces execution commands from service definitions. Platform consumes them and generates native service manager artifacts.

Install

cargo build --release
ln -sf target/release/orchd /usr/local/bin/orchd

Requires orch in PATH.

Commands

orchd generate [--force]
orchd up [services...] [--no-generate]
orchd down [services...]
orchd restart [services...]
orchd status [--json]
orchd logs <service> [-n lines] [--follow]
orchd health [--timeout 60s] [-v]
orchd list [--enabled] [--disabled] [--json]
orchd clean [--keep-data]

Global Flags

--orchfile <path>       Path to Orchfile (default: ./Orchfile)
--overlay <path>        Overlay file (repeatable)
--runtime <name>        bare (default)
--namespace <name>      Unit prefix (default: orch)
--state-dir <path>      Artifact directory (default: ~/.orch)
--data-dir <path>       Service data (default: <state-dir>/data)
--orch-bin <path>       orch binary (default: orch)
-v, --verbose
-q, --quiet

Configuration

.orchrc in project directory or $HOME, one KEY=VALUE per line:

runtime=bare
namespace=myapp
state_dir=/var/lib/myapp

Supported keys: runtime, platform, namespace, state_dir, data_dir, orch_bin, orchfile.

Merge order: CLI > environment > .orchrc > defaults.

Example

# Generate systemd units from Orchfile + bare overlay
orchd --orchfile ./Orchfile --overlay bare.orch generate

# Start all enabled services
orchd up

# Check health
orchd health --timeout 30s -v

# Tail logs
orchd logs postgres

# Stop everything and clean up
orchd clean

Tests

cargo test                        # 74 unit tests
cargo test -- --include-ignored   # + integration test (needs orch binary)

License

Apache 2.0