juanfont/headscale
Documented errors, page 4 of 7. Back to juanfont/headscale
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| allocating IPs | exception | critical | ip-allocation, capacity, registration, config, go |
| finding headscale | exception | error | integration, lifecycle, headscale |
| restoring foreign keys | console | error | database, sqlite, pragma, locking |
| getting user | exception | error | integration-test, user-management, grpc-api |
| saving approved routes to new column | exception | critical | database, migration, routes, json, update |
| tags in SSH source cannot access autogroup:member… | validation | error | policy, ssh, autogroup, validation, headscale |
| running pre-built tailscale container | exception | error | docker, integration, tailscale, image-management |
| users must be specified | validation | error | policy, ssh, configuration, validation, go |
| saving node to database | exception | error | go, database, registration, gorm, constraints |
| failed to parse ApiKey: prefix contains invalid characters | validation | warning | api-key, validation, base64url, user-input |
| oidc.issuer must be a valid http(s) URL | validation | error | headscale, config, oidc, url-validation |
| confirm form: no CSRF input | exception | error | html-parsing, integration, csrf, registration |
| %w: %q | validation | error | hi-runner, cli-flags, validation, capver |
| running pre-built headscale container | exception | error | integration-test, docker, prebuilt-image, registry |
| autogroup:self destination requires source to contain only… | validation | error | policy, ssh, autogroup, validation, headscale |
| creating preauth key | exception | error | integration-test, preauth-key, grpc-api |
| either --id or --prefix must be provided | validation | warning | cli, validation, flags, go |
| starting container | exception | error | docker, container-start, port-conflict, hi-runner |
| executing command, expected string | exception | warning | integration-test, assertion, eventual-consistency |
| starting postgres container | exception | error | integration-test, docker, postgres, dockertest |
| DERPer is not ready | exception | error | integration-test, derp, network, docker |
| parsing IP address from database | exception | error | database, ip-allocation, data-corruption, parsing |
| unknown --set value (want must|all) | validation | warning | integration, http, url-parsing, defensive |
| getting IPs | exception | error | integration, tailscale, readiness |
| upgrading noise connection | http | error | noise, handshake, network, ts2021 |
| adding test suite container to network | exception | error | docker, network, integration-test, test-runner |
| building sqlite connection URL | exception | error | database, sqlite, config, dsn |
errTrustedProxyZeroRange trusted_proxies[ ] : 0.0.0.0/0 and ::/0 are not allowed | validation | error | config, security, proxy, startup |
| oidc.client_id is required when oidc.issuer is set | validation | error | headscale, config, oidc, validation |
| registering existing node in database | exception | error | go, database, registration, gorm, concurrency |
| unexpected end of container wait | console | warning | integration, http, cookiejar, oidc, defensive |
| creating tailscale node | exception | error | tailscale, node, headscale, integration-test |
ErrUnsupportedClientVersion unsupported client version | http | warning | version-compat, noise, capability-version, upgrade |
| reading logs directory | exception | error | filesystem, cleanup, logs, hi |
| registering node | console | error | network, http-client, cli, registration, go |
errOIDCIssuerInvalid oidc.issuer must be a valid http(s) URL: got | validation | error | config, oidc, validation, startup, go |
| Internal error | http | error | ssh, config, url, internal-error |
| listing images | exception | error | docker, images, container-list, cleanup |
| automigrating types.PreAuthKey | console | critical | database, migration, gorm, preauth-key, foreign-key |
| creating metrics request | exception | error | metrics, http, integration-test, validation |
| invalid auth id | http | warning | auth, http, url-parameter, registration |
| authenticated principal has an unverified email | http | error | oidc, authorization, email, headscale |
| tag should be lowercase | validation | error | integration, oidc, html-parsing, login, template |
| : secret length mismatch, expected chars, got | validation | error | preauth-key, validation, key-format |
| HEADSCALE_CLI_API_KEY environment variable needs to be set | validation | warning | http, validation, ping, query-params |
| invalid owner format | validation | error | headscale, policy, tagowners, acl, validation |
| using pre auth key | exception | error | preauthkey, registration, database, go |
| input cannot end with a colon character | validation | error | policy, acl, parsing, ports |
| SSH tests entry must have at least one dst | validation | error | policy, ssh, tests, validation |
ErrSSHAuthSessionNotBound auth session is not for SSH check | http | warning | ssh, auth, session-binding, validation |
| only one of --id or --prefix can be provided | validation | warning | cli, validation, flags, go |
| authenticated principal is not in any allowed group | http | error | oidc, authorization, config, headscale |
| backfilling IPs | exception | error | go, database, ip-allocation, configuration, nil-guard |
| failed to convert node interface | exception | error | node, database, serialization, keys, headscale |
| inspecting image | exception | error | docker, image-inspect, permissions, daemon |
| unmarshalling key JSON | console | error | json, cli, dev-tooling, go |
| writing policy | exception | error | integration-test, acl-policy, hujson, docker |
| failed to parse ApiKey: prefix too short | validation | warning | api-key, validation, parsing, user-input |
| headscale version cannot be used with a database last used… | console | critical | versioning, database, migration, downgrade, startup |
| no cert domains available for HTTPS | console | warning | headscale, tailsql, tls, https, magicdns |
| : , can be | validation | error | policy, autogroup, acl, validation |
| approving auth request | console | error | network, http-client, cli, auth, go |
| creating api key | console | error | network, http-client, cli, go |
| invalid port range: first port is greater than last port | validation | error | policy, acl, parsing, port-range |
ErrHostnameTooLong creating valid FQDN ( ) | validation | error | dns, node, magicdns, validation |
| first port must be >0, or use '*' for wildcard | validation | error | policy, acl, parsing, ports |
| references undefined tag | validation | error | policy, tags, config, headscale |
| route is not available on node | validation | warning | routes, subnet, node, headscale |
| action must be specified | validation | error | policy, ssh, configuration, validation, go |
| creating directory failed with permission error | console | error | filesystem, permissions, startup, container |
| listing api keys | console | error | network, http-client, cli, go |
| dumping config | console | warning | filesystem, configuration, integration-test, go |
| node has neither user nor tags - must be owned by user or… | http | error | headscale, ownership, validation, data-integrity |
| database type not supported | validation | critical | config, database, startup, headscale |
| empty OIDC callback params | http | warning | oidc, auth, http, headscale |
| finding user | exception | error | oidc, users, database, registration, go |
| reading IPv4 addresses from database | exception | error | database, ip-allocation, ipv4, startup |
| rejecting auth request | console | error | network, http-client, cli, auth, go |
| parsing machine key | console | warning | cli, validation, debug, go |
| auth request rejected | http | error | integration, http, redirect, oidc, config |
| loading users for policy validation | console | error | database, policy, cli, bypass |
| : got , must be one of | validation | error | policy, acl, validation, autogroups, configuration, go |
| failed to parse oauth access token | exception | error | oauth, access-token, authentication, validation, headscale |
| group must start with 'group:' | validation | error | headscale, policy, groups, acl, validation |
| opening database | console | error | database, cli, bypass, sqlite, postgres |
| resolving destination | validation | warning | policy, acl, testing, resolution, hosts, go |
| type not supported | validation | error | headscale, policy, json, acl, type-error |
| creating node | console | error | network, http-client, cli, debug, go |
| registration info not in cache | http | error | oidc, pkce, cache, auth, headscale |
| username contains invalid character: '%c' | validation | error | username, dns, validation, oidc |
| error resolving host | validation | error | headscale, policy, hosts, acl, dns |
| Invalid auth_id | http | warning | ssh, auth, url-parameter, validation |
| reading path: , err | console | error | dns, filesystem, config-reload, fsnotify |
| creating directory for sqlite | exception | error | database, sqlite, filesystem, permissions, config |
| invalid prefix | validation | error | headscale, policy, cidr, prefix, validation |
| node marked as tagged but has no tags | http | error | headscale, tags, ownership, validation |
| confirm form: no value in CSRF input | exception | error | html-parsing, integration, csrf |
| : api key not found | validation | warning | cli, not-found, validation, go |
| path cannot be empty | validation | critical | sqlite, config, validation, database, headscale |
| tag must start with the string 'tag:' | validation | error | integration, http, oidc, login, status-code |