Closes #89. Adds five administrator pages to the existing Astro + Starlight site, covering the four questions the issue asks: Administration admin-setup cluster prerequisites, the single required value and everything derived from it, what the chart creates, the Keycloak bootstrap Job, and a verification checklist server-profiles profile_list sizing, profile_options image choices, access: all/yaml/keycloak gating, idle culling, and the two per-user PVCs nebi-integration what nebi-pack must already provide, the derived OIDC client IDs, the 3-step token exchange and its five inputs, both NetworkPolicies, workspace storage, and admin-provisioned registries mlflow-integration tracking URI, the egress rule, the client library, verification, and what the integration does not give you Reference values-reference field-by-field for keycloak, subdomains, nebariapp, singleuser, singleuserCuller, sharedStorage, nebi, rbac.bootstrap, jupyterhub.custom, and the upstream passthrough Content is derived from values.yaml, the templates, _helpers.tpl, and config/jupyterhub/*.py rather than paraphrased from the README, so the derivation rules and defaults match what the chart renders. Three things that are easy to get wrong get explicit callouts: - jupyterhub.hub.extraVolumes / extraVolumeMounts are lists, so overriding either drops the custom-config and oauth-client mounts and the hub silently falls back to dummy auth with an empty jupyterhub_config.d. - The base domain is keycloak.hostname minus its first label, so a single-label value derives an empty hub hostname, Nebi URL, and token URL - the chart renders and nothing routes. - z2jh defaults singleuser egress to deny private IPs, and a NetworkPolicy rule must name the pod port (5000 for MLflow), not the Service port, because the rule is evaluated after kube-proxy has already translated the ClusterIP. Existing pages are touched as little as possible so the other open docs PRs stay mergeable: configuration.md gains a "Detailed guides" list appended below its section table, and index.md gains an Administration section. Neither restructures what is there. Also adds a Documentation section to the README, which had no link to the published site.

Uh oh!

Commits

Commits on Aug 20, 2026

docs: document pack setup for administrators