Skip to content

Quick Start

This walkthrough uses the root justfile to build and run the Athena reference app.

Prereqs

  • Rust and rustup (for local builds).
  • just command runner.
  • Optional: Earthly plus Docker/Podman for containerized builds.
just check-local-build
just build-run-dev-fastest

Containerized flow (matches CI)

just build-run-dev

Verify the gateway

curl -H "Host: app.hermes.local" http://localhost:5000/api/gateway/v1/rbac/registration

Clean state

Hermes persists per-app state in ~/.hermes/*.hfs.

just clean-hfs