ghcr.io/the-40-thieves/reliquary-tc:latest. Use :latest to follow the
current release, or replace it with :<version> when a deployment must stay on one release.
Stdio
For an MCP client that starts one process per session, keep stdin open and mount the vault:docker-compose.yml is the configurable stdio form. Point
OBSIDIAN_VAULT_PATH at the host vault, create the config described in that file’s header, then
run:
up -d; it deliberately models a stdio session rather than
a network service.
HTTP server
deploy/compose.http.yml
runs the image as a long-lived HTTP service. From the repository’s deploy/ directory:
/data/vault— themainvault;/data/cache— indexes, model data, and the authentication registry.
bun user. The Compose file mounts ./config as a read-only
directory so replacing the config file does not leave a bind mount pinned to the old inode.
The shipped config sets transports.http.host to 0.0.0.0 because the default loopback bind is not
reachable through Docker port publishing. It also sets transports.stdio to false because a
detached HTTP container has no stdio client. Neither setting has an environment overlay.
RELIQUARY_TC_PUBLIC_URL is required. It derives auth.resource as the public origin plus /mcp
and adds the public hostname to allowedHosts; without an audience/resource, the loader refuses a
JWT server bound to 0.0.0.0. RELIQUARY_TC_JWT_SECRET is also required by this HS256 setup.
Mint a client token inside the running container. The command inherits the same config, secret,
resource, cache, and vault path as the server:
Authorization: Bearer <token> to
$RELIQUARY_TC_PUBLIC_URL/mcp. Add only the scopes that client needs.
Healthcheck behavior
The image probeshttp://127.0.0.1:${PORT:-8765}/healthz every 30 seconds, with a 10-second timeout,
a 60-second start period, and three retries. A 200 response is healthy. When PORT is set, refusal,
timeout, and every non-200 response are unhealthy. When PORT is unset, connection refusal is
healthy so a long-running stdio-only container is not restarted merely because it has no HTTP
listener; timeouts and non-200 responses still fail. /healthz is unauthenticated liveness only.
The Compose file inherits this image healthcheck and does not duplicate it.
Git-backed vault (-git image)
The -git variant keeps the vault in step with a Git remote. It is the default image plus git and
openssh-client, about 165 MB (157 MiB) larger, measured on the first -git build. The default image
is unchanged and has neither tool.
Its tags follow the same scheme with a suffix: ghcr.io/the-40-thieves/reliquary-tc:<version>-git,
and :latest-git for the current release. The -git tags are first published with the next
release. Before that, build the image from a checkout with docker build --target git -t reliquary-tc:git ..
The entrypoint is reliquary-tc git-sync --supervise. It clones the remote into /data/vault (or
verifies an existing clone), runs one pull, and starts the server as a child process. Arguments
after -- go to the server, as in git-sync --supervise -- <server args>. With no arguments, the
server reads its configuration from the environment, as in the HTTP example above.
-e NAME passes the variable from the calling shell, so the SSH key and the JWT secret stay
off the command line. RELIQUARY_TC_VAULT_GIT_SSH_KEY holds the private key contents. For an HTTPS
remote, pass RELIQUARY_TC_VAULT_GIT_TOKEN instead. The variables and their defaults are in
docs/SYNC.md.
For Compose, deploy/compose.git.yml
is the -git sibling of compose.http.yml. It has the same volume and config layout and reads the
SSH key from the environment.
Health and restart. The image healthcheck described above probes only the server’s /healthz.
A sync failure does not fail it: the sidecar records the error in status.json under the state
directory, /data/cache/git-sync, writes it to stderr, and retries on the next tick. The container
exits when either process exits: the server, or the sync loop if it stops with an error. A boot
refusal, such as a directory that holds files but is not a clone of the remote, exits before the
server starts. The restart policy then restarts the container, so set --restart unless-stopped as above.
Platform bundles
- Render — Blueprint, persistent disk, generated setup token, and Render health check configuration.
- Railway — repository Dockerfile, volume, environment, and Railway health check configuration.
- Fly.io —
fly.tomlwith the published image, one volume, and a/healthzcheck. - VPS (cloud-init) — Ubuntu 24.04 user data with Docker, Caddy and a generated JWT secret.
- Home server — Umbrel, CasaOS / ZimaOS and Unraid templates for a LAN, with a bearer token and an exact allow-list of hosts.
- Self-hosted PaaS — Coolify, Dokploy and CapRover templates derived from the HTTP Compose bundle.