Self-host AnchorShell Relay

Self-host AnchorShell Relay

A concise deployment checklist for AnchorShell Relay — Self-Hosted.

Last updated July 10, 2026

Deployment checklist

  1. Use the Go and Node versions documented by the current public repository.
  2. Create a private environment from the repository example.
  3. Set distinct local values for the admin token and credential-encryption master key.
  4. Build the embedded UI and Go binary through the repository’s supported Makefile workflow.
  5. Place the service behind the network controls appropriate for an administrative gateway.
  6. Configure one supported OpenAI-compatible upstream, credential, endpoint/model, and lane.
  7. Add conservative request/token/concurrency limits before production traffic.
  8. Configure endpoint pricing if cost estimates and spend policies are required.
  9. Verify streaming and non-streaming behavior for the selected upstream.
  10. Monitor queue, request, usage, and endpoint cooldown views.

Back up the right state

Back up the SQLite database and protect the master key separately. The database contains encrypted credential envelopes; the master key is required to recover them. Active queued work is in memory and is not part of a database backup.

Use the public repository README as the source for current commands. This guide intentionally avoids claiming a deployment topology or license that the repository does not currently guarantee.