SEQN Auth Docs Hosting

Public SEQN Auth docs should be hosted at:


https://docs.seqn.in

This is the confirmed public docs domain for the Clerk-like SEQN Auth product. The auth runtime stays on accounts.seqn.in; Authentik stays on auth.seqn.in.

DNS

Create one public DNS record before enabling the Caddy route:


docs.seqn.in A 80.225.246.45

If the DNS provider uses proxying/CDN mode, keep HTTPS passthrough compatible with Caddy automatic certificates. Do not point docs.seqn.in at accounts.seqn.in; docs should be a separate host.

VPS layout

Use a static output directory outside the app containers:


/srv/silver-auth/docs-site/public

The directory can be populated by any static docs builder. For the current Markdown-only docs, publish generated static HTML into that directory and keep the repo Markdown as the source of truth.

Recommended ownership on the VPS:


sudo mkdir -p /srv/silver-auth/docs-site/public
sudo chown -R root:root /srv/silver-auth/docs-site
sudo chmod -R u=rwX,g=rX,o=rX /srv/silver-auth/docs-site

Caddy

Use services/silver-auth-api/deploy/docs-site.Caddyfile as the route template. If the VPS uses the existing shared Caddy proxy, copy the docs.seqn.in block into the active Caddyfile beside the auth.seqn.in and accounts.seqn.in blocks.

The route serves static files only and does not proxy to the Silver Auth API.

Deploy checklist

  • Generate static docs into /srv/silver-auth/docs-site/public.
  • Add the docs.seqn.in Caddy block.
  • Reload Caddy after caddy validate passes.
  • Confirm https://docs.seqn.in/ loads over HTTPS.
  • Confirm missing pages do not expose directory listings.
  • Add external uptime monitoring for https://docs.seqn.in/.

Current blocker

Actual DNS creation and TLS verification require DNS-provider access for seqn.in. Until the docs.seqn.in record exists, this repository can only provide the hosting runbook and Caddy template.