Self-host AnchorShell Relay

Self-host AnchorShell Relay

Run AnchorShell Relay with local secrets, SQLite-backed configuration, and embedded administration.

Last updated July 10, 2026

Runtime requirements

AnchorShell Relay — Self-Hosted is a Go single-binary service with an embedded Nuxt administration UI. The current repository expects Go 1.26.4 or a newer compatible patch and Node 22 for rebuilding frontend assets.

Local secrets

Standalone administration uses BOUNCER_ADMIN_TOKEN. Provider credential encryption uses a separate BOUNCER_MASTER_KEY. Keep both values out of source control and never reuse one as the other.

Provider credentials are encrypted with AES-256-GCM before database storage. Losing the master key means existing encrypted provider credentials cannot be recovered.

Basic workflow

  1. Prepare the environment from the repository example.
  2. Build or run the service using the repository Makefile.
  3. Open the embedded admin UI and authenticate locally.
  4. Configure a provider, credential, endpoint/model, and optional Relay Lane.
  5. Add limit and pricing policies appropriate for the upstream.
  6. Send supported requests to the local /v1 gateway.

Persistence boundary

SQLite stores configuration, limits, pricing, request logs, and usage data. The active request queue is in memory and queued work does not survive a service restart.

Review the public repository README for current commands and version details before deploying.