Skip to content
Domains and URLs

Domains and URLs

With BASE_DOMAIN=example.com and CONTENT_DOMAIN=example-content.net:

URLServes
https://example.comThis documentation site.
https://console.example.comThe web console, its API and ownscale’s OIDC provider.
https://console.example.com/invite/<token>Invite links.
https://<org>.example.comThe organization’s login server (its Headscale instance). Used with tailscale up --login-server.
https://<label>-<org>.example-content.netA funnel.
<machine>.<tailnet label>.os.example-content.netA machine’s MagicDNS name, used for HTTPS certificates. Only resolvable inside the tailnet.
https://example.com/s/<slug>Short links into the documentation, used by the console.

Without a separate CONTENT_DOMAIN, funnels and machine names use example.com too.

Naming rules

NameRules
Organization subdomain4 to 63 lowercase letters and digits. Chosen by ownscale. admin, auth, console, derp, docs and www are reserved.
Funnel label1 to 63 lowercase letters and digits, no hyphens, unique per organization.
Tailnet labelRandom, chosen when the organization is created, and can’t be changed.

Hyphens aren’t allowed in organization subdomains or funnel labels, so a funnel’s <label>-<org> host can’t be confused with another one.