headplane: Cannot authenicate via OIDC with code 500 Internal Server Error
Description
I’m trying to setup/upgrade both Headscale and Headplane to the newest version, after ODIC authorization I’m receiving code 500 Internal Server Error with the following printed in headplane logs:
2025-04-06T07:58:00.899Z [server] INFO: Running Node.js 22.14.0
2025-04-06T07:58:00.981Z [config] INFO: Found a valid configuration file at /etc/headplane/config.yaml
2025-04-06T07:58:01.091Z [config] INFO: Found a valid Headscale configuration file at /etc/headscale/config.yaml
2025-04-06T07:58:01.207Z [config] INFO: Using user database file at /var/lib/headplane/users.json
2025-04-06T07:58:01.218Z [config] INFO: Using Docker integration
2025-04-06T07:58:01.220Z [config] INFO: Using container: headscale
2025-04-06T07:58:01.221Z [config] INFO: Checking socket: /var/run/docker.sock
2025-04-06T07:58:07.531Z [config] INFO: Using https://auth.b4iterdev.id.vn/application/o/headscale/ as the OIDC issuer
2025-04-06T07:58:07.585Z [server] INFO: Running on 0.0.0.0:3000
2025-04-06T08:18:14.839Z [auth] ERROR: Unknown error: TypeError: fetch failed
at node:internal/deps/undici/undici:13502:13
at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
at async tokenEndpointRequest (file:///app/build/server/assets/index-CD2MsUX2.js:205150:22)
at async authorizationCodeGrant (file:///app/build/server/assets/index-CD2MsUX2.js:208014:22)
at async finishAuthFlow (file:///app/build/server/assets/server-build.js:49655:18)
at async loader$b (file:///app/build/server/assets/server-build.js:49823:18)
at async callRouteHandler (file:///app/build/server/assets/index-CD2MsUX2.js:10343:16)
at async commonRoute.loader (file:///app/build/server/assets/index-CD2MsUX2.js:10452:19)
at async file:///app/build/server/assets/index-CD2MsUX2.js:7108:19
at async callLoaderOrAction (file:///app/build/server/assets/index-CD2MsUX2.js:7158:16) {
[cause]: [AggregateError]
}
Here’s my headplane config:
# Configuration for the Headplane server and web application
server:
host: "0.0.0.0"
port: 3000
# The secret used to encode and decode web sessions
# Ensure that this is exactly 32 characters long
cookie_secret: "REDACTED"
# Should the cookies only work over HTTPS?
# Set to false if running via HTTP without a proxy
# (I recommend this is true in production)
cookie_secure: true
# Headscale specific settings to allow Headplane to talk
# to Headscale and access deep integration features
headscale:
# The URL to your Headscale instance
# (All API requests are routed through this URL)
# (THIS IS NOT the gRPC endpoint, but the HTTP endpoint)
#
# IMPORTANT: If you are using TLS this MUST be set to `https://`
url: "https://headscale.b4iterdev.net.eu.org"
# If you use the TLS configuration in Headscale, and you are not using
# Let's Encrypt for your certificate, pass in the path to the certificate.
# (This has no effect `url` does not start with `https://`)
# tls_cert_path: "/var/lib/headplane/tls.crt"
# Optional, public URL if they differ
# This affects certain parts of the web UI
public_url: "https://headscale.b4iterdev.net.eu.org"
# Path to the Headscale configuration file
# This is optional, but HIGHLY recommended for the best experience
# If this is read only, Headplane will show your configuration settings
# in the Web UI, but they cannot be changed.
config_path: "/etc/headscale/config.yaml"
# Headplane internally validates the Headscale configuration
# to ensure that it changes the configuration in a safe way.
# If you want to disable this validation, set this to false.
config_strict: true
# Integration configurations for Headplane to interact with Headscale
# Only one of these should be enabled at a time or you will get errors
integration:
docker:
enabled: true
# The name (or ID) of the container running Headscale
container_name: "headscale"
# The path to the Docker socket (do not change this if you are unsure)
# Docker socket paths must start with unix:// or tcp:// and at the moment
# https connections are not supported.
socket: "unix:///var/run/docker.sock"
# Please refer to docs/integration/Kubernetes.md for more information
# on how to configure the Kubernetes integration. There are requirements in
# order to allow Headscale to be controlled by Headplane in a cluster.
kubernetes:
enabled: false
# Validates the manifest for the Pod to ensure all of the criteria
# are set correctly. Turn this off if you are having issues with
# shareProcessNamespace not being validated correctly.
validate_manifest: true
# This should be the name of the Pod running Headscale and Headplane.
# If this isn't static you should be using the Kubernetes Downward API
# to set this value (refer to docs/Integrated-Mode.md for more info).
pod_name: "headscale"
# Proc is the "Native" integration that only works when Headscale and
# Headplane are running outside of a container. There is no configuration,
# but you need to ensure that the Headplane process can terminate the
# Headscale process.
#
# (If they are both running under systemd as sudo, this will work).
proc:
enabled: false
# OIDC Configuration for simpler authentication
# (This is optional, but recommended for the best experience)
oidc:
issuer: "https://auth.b4iterdev.id.vn/application/o/headscale/"
client_id: "REDACTED"
# The client secret for the OIDC client
# Either this or `client_secret_path` must be set for OIDC to work
client_secret: "REDACTED"
# You can alternatively set `client_secret_path` to read the secret from disk.
# The path specified can resolve environment variables, making integration
# with systemd's `LoadCredential` straightforward:
# client_secret_path: "${CREDENTIALS_DIRECTORY}/oidc_client_secret"
disable_api_key_login: true
token_endpoint_auth_method: "client_secret_post"
# If you are using OIDC, you need to generate an API key
# that can be used to authenticate other sessions when signing in.
#
# This can be done with `headscale apikeys create --expiration 999d`
headscale_api_key: "REDACTED"
# Optional, but highly recommended otherwise Headplane
# will attempt to automatically guess this from the issuer
#
# This should point to your publicly accessibly URL
# for your Headplane instance with /admin/oidc/callback
redirect_uri: "https://headscale.b4iterdev.net.eu.org/admin/oidc/callback"
# Stores the users and their permissions for Headplane
# This is a path to a JSON file, default is specified below.
user_storage_file: "/var/lib/headplane/users.json"
OIDC Provider
Authentik 2025.2.3
Headplane Version
v0.5.10
Headscale Version
v0.25.1
About this issue
- Original URL
- State: closed
- Created 2 years ago
- Comments: 20 (5 by maintainers)
@Tigo72 this is best done in a discussion thread so please open one up if you feel its necessary. But users only show up once they have authenticated with Headscale. Headplane doesn’t keep track of users like that.
I second that, having the same issue with Authentik. Thought it was my setup.