mirror of
https://github.com/juanfont/headscale.git
synced 2025-07-21 06:21:17 -04:00
d461db3abd
Restructure and rewrite the OpenID Connect documentation. Start from the most minimal configuration and describe what needs to be done both in Headscale and the identity provider. Describe additional features such as PKCE and authorization filters in a generic manner with examples. Document how Headscale populates its user profile and how it relates to OIDC claims. This is a revised version from the table in the changelog. Document the validation rules for fields and extend known limitations. Sort the provider specific section alphabetically and add a section for Authelia, Authentik, Kanidm and Keycloak. Also simplify and rename Azure to Entra ID. Update the description for the oidc section in the example configuration. Give a short explanation of each configuration setting. All documentend features were tested with Headscale 0.26 (using a fresh database each time) using the following identity providers: * Authelia * Authentik * Kanidm * Keycloak Fixes: #2295
189 lines
5.0 KiB
YAML
189 lines
5.0 KiB
YAML
---
|
|
site_name: Headscale
|
|
site_url: https://juanfont.github.io/headscale/
|
|
edit_uri: blob/main/docs/ # Change the master branch to main as we are using main as a main branch
|
|
site_author: Headscale authors
|
|
site_description: >-
|
|
An open source, self-hosted implementation of the Tailscale control server.
|
|
|
|
# Repository
|
|
repo_name: juanfont/headscale
|
|
repo_url: https://github.com/juanfont/headscale
|
|
|
|
# Copyright
|
|
copyright: Copyright © 2025 Headscale authors
|
|
|
|
# Configuration
|
|
theme:
|
|
name: material
|
|
features:
|
|
- announce.dismiss
|
|
- content.action.edit
|
|
- content.action.view
|
|
- content.code.annotate
|
|
- content.code.copy
|
|
# - content.tabs.link
|
|
- content.tooltips
|
|
# - header.autohide
|
|
# - navigation.expand
|
|
- navigation.footer
|
|
- navigation.indexes
|
|
# - navigation.instant
|
|
# - navigation.prune
|
|
- navigation.sections
|
|
- navigation.tabs
|
|
# - navigation.tabs.sticky
|
|
- navigation.top
|
|
- navigation.tracking
|
|
- search.highlight
|
|
- search.share
|
|
- search.suggest
|
|
- toc.follow
|
|
# - toc.integrate
|
|
palette:
|
|
- scheme: default
|
|
primary: white
|
|
toggle:
|
|
icon: material/brightness-7
|
|
name: Switch to dark mode
|
|
- scheme: slate
|
|
toggle:
|
|
icon: material/brightness-4
|
|
name: Switch to light mode
|
|
font:
|
|
text: Roboto
|
|
code: Roboto Mono
|
|
favicon: assets/favicon.png
|
|
logo: ./logo/headscale3-dots.svg
|
|
|
|
# Excludes
|
|
exclude_docs: |
|
|
/requirements.txt
|
|
|
|
# Plugins
|
|
plugins:
|
|
- search:
|
|
separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
|
|
- macros:
|
|
- include-markdown:
|
|
- minify:
|
|
minify_html: true
|
|
- mike:
|
|
- social: {}
|
|
- redirects:
|
|
redirect_maps:
|
|
acls.md: ref/acls.md
|
|
android-client.md: usage/connect/android.md
|
|
apple-client.md: usage/connect/apple.md
|
|
dns-records.md: ref/dns.md
|
|
exit-node.md: ref/routes.md
|
|
ref/exit-node.md: ref/routes.md
|
|
faq.md: about/faq.md
|
|
iOS-client.md: usage/connect/apple.md#ios
|
|
oidc.md: ref/oidc.md
|
|
remote-cli.md: ref/remote-cli.md
|
|
reverse-proxy.md: ref/integration/reverse-proxy.md
|
|
tls.md: ref/tls.md
|
|
web-ui.md: ref/integration/web-ui.md
|
|
windows-client.md: usage/connect/windows.md
|
|
|
|
# Customization
|
|
extra:
|
|
version:
|
|
alias: true
|
|
provider: mike
|
|
annotate:
|
|
json: [.s2]
|
|
social:
|
|
- icon: fontawesome/brands/github
|
|
link: https://github.com/juanfont/headscale
|
|
- icon: material/coffee
|
|
link: https://ko-fi.com/headscale
|
|
- icon: fontawesome/brands/docker
|
|
link: https://github.com/juanfont/headscale/pkgs/container/headscale
|
|
- icon: fontawesome/brands/discord
|
|
link: https://discord.gg/c84AZQhmpx
|
|
headscale:
|
|
version: 0.26.0
|
|
|
|
# Extensions
|
|
markdown_extensions:
|
|
- abbr
|
|
- admonition
|
|
- attr_list
|
|
- def_list
|
|
- footnotes
|
|
- md_in_html
|
|
- toc:
|
|
permalink: true
|
|
- pymdownx.arithmatex:
|
|
generic: true
|
|
- pymdownx.betterem:
|
|
smart_enable: all
|
|
- pymdownx.caret
|
|
- pymdownx.details
|
|
- pymdownx.emoji:
|
|
emoji_generator: !!python/name:material.extensions.emoji.to_svg
|
|
emoji_index: !!python/name:material.extensions.emoji.twemoji
|
|
- pymdownx.highlight:
|
|
anchor_linenums: true
|
|
line_spans: __span
|
|
pygments_lang_class: true
|
|
- pymdownx.inlinehilite
|
|
- pymdownx.keys
|
|
- pymdownx.magiclink:
|
|
repo_url_shorthand: true
|
|
user: squidfunk
|
|
repo: mkdocs-material
|
|
- pymdownx.mark
|
|
- pymdownx.smartsymbols
|
|
- pymdownx.superfences:
|
|
custom_fences:
|
|
- name: mermaid
|
|
class: mermaid
|
|
format: !!python/name:pymdownx.superfences.fence_code_format
|
|
- pymdownx.tabbed:
|
|
alternate_style: true
|
|
- pymdownx.tasklist:
|
|
custom_checkbox: true
|
|
- pymdownx.tilde
|
|
|
|
# Page tree
|
|
nav:
|
|
- Welcome: index.md
|
|
- About:
|
|
- FAQ: about/faq.md
|
|
- Features: about/features.md
|
|
- Clients: about/clients.md
|
|
- Getting help: about/help.md
|
|
- Releases: about/releases.md
|
|
- Contributing: about/contributing.md
|
|
- Sponsor: about/sponsor.md
|
|
|
|
- Setup:
|
|
- Requirements and Assumptions: setup/requirements.md
|
|
- Installation:
|
|
- Official releases: setup/install/official.md
|
|
- Community packages: setup/install/community.md
|
|
- Container: setup/install/container.md
|
|
- Build from source: setup/install/source.md
|
|
- Upgrade: setup/upgrade.md
|
|
- Usage:
|
|
- Getting started: usage/getting-started.md
|
|
- Connect a node:
|
|
- Android: usage/connect/android.md
|
|
- Apple: usage/connect/apple.md
|
|
- Windows: usage/connect/windows.md
|
|
- Reference:
|
|
- Configuration: ref/configuration.md
|
|
- OpenID Connect: ref/oidc.md
|
|
- Routes: ref/routes.md
|
|
- TLS: ref/tls.md
|
|
- ACLs: ref/acls.md
|
|
- DNS: ref/dns.md
|
|
- Remote CLI: ref/remote-cli.md
|
|
- Integration:
|
|
- Reverse proxy: ref/integration/reverse-proxy.md
|
|
- Web UI: ref/integration/web-ui.md
|
|
- Tools: ref/integration/tools.md
|