Add instance-discovery document + serving guide #69

Closed

raisondetredev wants to merge 1 commit from refs/pull/69/head into main

raisondetredev commented

2026-07-01 14:02:47 +02:00

(Migrated from codeberg.org)

App PR: project-halkyon/halkyon-learn#712

discovery/halkyon-learn.json — the canonical document (fill in anonKey).
discovery/README.md — the contract (fields, CORS, https/path
normalisation) plus Caddy / nginx / Traefik snippets for serving it from the
reverse proxy fronting learn.halkyon.li, outside Kong so no apikey is
required.

After merge: fill in anonKey and add the proxy route on the server (not
version-controlled here).

Serves the public discovery document that Halkyon Learn's new domain-based login fetches to learn a self-hosted instance's Supabase config — so learners never type a publishable key (the Supabase analogue of Mastodon's `/api/v1/instance`; the anon key is publishable, so it's safe to serve unauthenticated). App PR: project-halkyon/halkyon-learn#712 - `discovery/halkyon-learn.json` — the canonical document (fill in `anonKey`). - `discovery/README.md` — the contract (fields, CORS, `https`/path normalisation) plus Caddy / nginx / Traefik snippets for serving it from the reverse proxy fronting `learn.halkyon.li`, outside Kong so no `apikey` is required. After merge: fill in `anonKey` and add the proxy route on the server (not version-controlled here).