ErrLookup › juanfont/headscale
juanfont/headscale
An open source, self-hosted implementation of the Tailscale control server · Go · 183 source files
Analyzed at 565fd254d0 on 2026-08-15. 620 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| Fatal config error | validation | critical | config, validation, startup, aggregated-error |
| creating directory failed with permission error | console | error | filesystem, permissions, startup, config |
| - see details above | exception | error | hi-runner, pre-flight, docker, environment-checks |
| recovering user_id on untagged nodes | exception | critical | database, migration, data-repair, foreign-key, tags |
| auto approving routes | exception | error | routes, auto-approval, registration, database, policy |
| ( ); use autogroup:tagged or specific tags as destinations… | validation | error | policy, ssh, tags, security-model, validation |
| DERP server private key and noise private key are the same | console | critical | derp, noise, crypto-keys, configuration, startup |
| reading or creating Noise protocol private key | console | critical | noise, crypto-keys, filesystem, permissions, startup |
| : overlaps | validation | error | policy, nodeattrs, ippool, reserved-ranges, validation |
| initial DERPMap is empty, Headscale requires at least one… | validation | critical | config, derp, relay, startup, headscale |
| init state | console | critical | startup, database, state, migrations, configuration |
| 0.0.0.0/0 and ::/0 are not allowed | validation | error | config, networking, validation, reverse-proxy |
| given name already in use by another node | http | error | state, dns, rename, node, uniqueness |
| machine key maps to ambiguous node ownership | http | error | headscale, registration, ownership, tags, data-integrity |
| creating Docker client | exception | error | docker, docker-sdk, configuration, env-vars |
| unknown field | validation | error | policy, hujson, config, validation |
| extracting logs | exception | warning | docker, logging, integration-tests, hi-runner |
| listing updated clients | exception | error | integration-test, docker, retry, headscale-cli |
| marshaling expected online map | exception | warning | json, mapresponses, serialization |
| invalid SSH action | validation | info | policy, ssh, dead-code, sentinel, go |
| src= | validation | error | policy, acl, tags, tagowners, validation |
| parsing private key | console | critical | crypto-keys, configuration, data-corruption, startup |
| reading map responses from directory | exception | error | mapresponses, json, filesystem, integration-tests |
| tag not found | validation | error | policy, grants, via, tags, tagowners, validation |
| building headscale | console | error | dev-tooling, build, go-toolchain, compile |
| nodeAttrs target does not support this autogroup | validation | error | headscale, policy, acl, autogroup, nodeattrs, validation |
| health check timed out | console | warning | http, debug, access-control, network, reverse-proxy |
| SSH tests dst contains unknown tag | validation | error | policy, ssh, tests, tags, validation |
| : (%T) | validation | error | policy, nodeattrs, groups, validation |
| user | validation | error | policy, ssh, users, validation |
| MOCKOIDC_PORT not defined | validation | error | versioning, noise, client-compatibility, registration |
| creating prefix index | exception | critical | database, migration, unique-index, gorm, preauthkey |
| registration expired | http | error | headscale, registration, auth, timeout, cache |
| protocol does not support specific ports | validation | error | policy, acl, protocol, ports, validation |
| waiting for headscale | console | error | dev-tooling, health-check, startup, timeout |
| failed to allocate IP | exception | error | ip-allocation, capacity, config, node-registration, headscale |
| creating index | exception | critical | database, sqlite, migration, index, unique-constraint |
| updating tags for node | exception | critical | database, migration, nodes, tags, locking |
| foreign key constraints violated | exception | critical | database, sqlite, migration, data-integrity, headscale |
| server_url cannot be part of base_domain in a way that… | validation | error | headscale, config, dns, magicdns, networking |
| handling register with auth key | exception | error | authentication, preauth-key, registration, database |
| renaming forced_tags to tags | exception | critical | database, migration, rename, gorm, schema-drift |
| test(s) failed | validation | error | policy, acl, validation, headscale |
| creating oauth_clients index | exception | critical | database, migration, oauth, unique-index, postgres |
| cannot remove all tags from node | validation | error | tags, node-ownership, state, api |
| setting up extrarecord manager | console | error | dns, configuration, json, fsnotify, startup |
| ; use autogroup:self instead for same-user SSH access | validation | error | policy, ssh, autogroup-self, validation |
| creating oauth_access_tokens index | exception | critical | database, migration, oauth, unique-index, transaction-aborted |
| node key already in use by another machine | http | error | headscale, registration, node-key, conflict, cloning |
| starting headscale | console | error | dev-tooling, process, exec, environment |
| ssh action: cached auth session is not an SSH-check binding | http | error | ssh, noise, auth, headscale |
| starting headscale container | exception | error | integration-test, docker-build, diagnostics, docker-daemon |
| creating oauth_clients table | exception | critical | database, migration, oauth, ddl, create-table |
| MOCKOIDC_CLIENT_SECRET not defined | validation | error | network, noise, websocket, reverse-proxy, registration |
| unsupported policy mode | validation | error | headscale, config, policy, startup |
| creating pre-auth key | console | error | dev-tooling, cli, preauthkey, provisioning |
| reading or creating DERP server private key | console | critical | derp, crypto-keys, filesystem, permissions, startup |
| test failed | exception | error | memory, resource-limits, stats, hi-runner, performance |
| creating request | console | warning | dev-tooling, http, health-check, context-cancellation |
| headscale version cannot be used with a database last used… | console | critical | versioning, database, migration, upgrade, startup |
| saving oauth access token | exception | error | go, oauth, access-token, race-condition, database |
| invalid localpart format, must be localpart:*@ | validation | error | policy, ssh, localpart, configuration, validation, go |
| group value must be an array of users | validation | error | policy, json, validation, headscale, groups |
| getting DERPMap | console | critical | derp, derpmap, network, configuration, startup |
| deleting ephemeral node | exception | error | ephemeral-nodes, logout, database, registration |
| : exit code | exception | error | go-test, assertion-failure, integration-tests, hi-runner |
| saving private key to disk at path | console | critical | crypto-keys, filesystem, permissions, disk-space, startup |
| executing test | exception | error | docker, container-wait, streaming, hi-runner, flaky |
| creating new table | exception | critical | database, sqlite, migration, ddl, backup |
| dst | validation | error | policy, grants, cidr, default-route, validation |
| configuring TLS settings | console | critical | tls, certificates, startup, configuration, lets-encrypt |
| failed to parse auth-key | http | error | preauth-key, validation, registration, headscale, go |
| alias not supported for SSH destination | validation | error | policy, ssh, validation, json |
| go mod vendor | exception | error | go-modules, tooling, vendorhash, build |
| node no longer exists in NodeStore | http | error | headscale, node, race, nodestore, concurrency |
| copying data | exception | critical | database, sqlite, migration, unique-constraint, data-migration |
| failed to parse ApiKey: invalid display prefix format | validation | warning | api-key, validation, dead-code, parsing |
| %w %q | validation | error | policy, ssh, hosts, validation |
| creating user | console | error | dev-tooling, cli, users, provisioning |
| invalid first integer | validation | error | policy, acl, parsing, ports |
| saving API key to database | http | error | database, gorm, api-key, sqlite, bcrypt |
| dst= | validation | error | policy, acl, tags, tagowners, validation |
| handling logout | exception | error | authentication, logout, database, registration |
| handling register interactive | exception | error | authentication, registration, interactive-login, database |
| no IPv4 or IPv6 prefix configured, minimum one prefix is… | validation | critical | config, ip-allocation, validation, startup |
| ensuring image availability | exception | error | docker, image-pull, integration-tests, hi-runner, network |
| loading nodes for RequestTags migration | exception | critical | database, migration, nodes, policy, memory |
| autogroup:internet not valid as a test destination | validation | error | policy, tests, autogroup, exit-node |
| creating default TLS certificates | exception | error | integration-test, tls, certificate, x509 |
| finding new client | exception | error | integration-test, diffing, concurrency |
| proto name "*" not known; use protocol number 0-255 or… | validation | error | policy, acl, protocol, wildcard, validation |
| test destination port must be a single port | validation | error | policy, tests, ports, validation |
| adding prefix column | exception | critical | database, migration, gorm, sqlite, postgres, startup |
| api error ( ) | http | error | api, http, cli, oauth |
| input must contain a colon character separating destination… | validation | error | policy, acl, parsing, ports |
| node not found | http | error | headscale, node, not-found, api |
| test protocol must be tcp, udp, sctp, or empty | validation | error | policy, tests, protocol, validation |
| autogroup:internet can only be used in ACL destinations | validation | error | policy, autogroup, acl, ssh, validation |
| autogroup not supported for SSH destinations | validation | error | policy, autogroup, ssh, validation |
| cleaning stale test containers | console | error | docker, integration-tests, cleanup, hi |