gsadmin/headplane
1
0
Fork 0
mirror of https://github.com/tale/headplane.git synced 2026-08-20 18:02:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update some option docs

Browse Source
This commit is contained in:
Aarnav Tale
2026-03-29 20:30:53 -04:00
parent 9ac3ab1861
commit a5e2af9b30
3 changed files with 48 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files
nix/options.nix
+21 -17
View File
@@ -166,6 +166,16 @@ in {
'';
};
api_key_path = mkOption {
type = types.nullOr types.path;
default = null;
description = ''
Path to a file containing the Headscale API key.
Required for OIDC authentication and the Headplane agent.
'';
example = "config.sops.secrets.headscale_api_key.path";
};
dns_records_path = mkOption {
type = types.nullOr types.path;
default = null;
@@ -192,23 +202,13 @@ in {
type = types.bool;
default = false;
description = ''
The Headplane agent allows retrieving information about nodes.
This allows the UI to display version, OS, and connectivity data.
You will see the Headplane agent in your Tailnet as a node when it connects.
The Headplane agent periodically syncs node information (version, OS, etc.)
from your Tailnet. It auto-generates ephemeral pre-auth keys using
headscale.api_key, so no manual key configuration is needed.
Requires Headscale 0.28 or newer.
'';
};
pre_authkey_path = mkOption {
type = types.nullOr types.path;
default = null;
description = ''
Path to a file containing the agent preauth key.
To connect to your Tailnet, you need to generate a pre-auth key.
This can be done via the web UI or through the `headscale` CLI.
'';
example = "config.sops.secrets.agent_pre_authkey.path";
};
host_name = mkOption {
type = types.str;
default = "headplane-agent";
@@ -224,10 +224,13 @@ in {
'';
};
cache_path = mkOption {
executable_path = mkOption {
type = types.path;
default = "/var/lib/headplane/agent_cache.json";
description = "Where to store the agent cache.";
default = "/usr/libexec/headplane/agent";
description = ''
Path to the Headplane agent binary.
The default is correct if using the NixOS module package.
'';
};
work_dir = mkOption {
@@ -338,6 +341,7 @@ in {
type = types.nullOr types.path;
default = null;
description = ''
DEPRECATED: Use headscale.api_key_path instead.
Path to a file containing the Headscale API key.
'';
example = "config.sops.secrets.headscale_api_key.path";