ErrLookup › henrygd/beszel
henrygd/beszel
Lightweight server monitoring with historical data, docker stats, and alerts. · Go · 220 source files
Analyzed at b38fb7dafa on 2026-08-31. 103 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
| invalid signature - check KEY value | error_code | error | authentication, signature, crypto, websocket |
| invalid release digest | validation | error | checksum, digest-format, self-update, github-release |
| failed replacing the executable | exception | error | self-update, filesystem, rename, permissions |
| the executable in the extracted path is missing or it is… | exception | error | archive, extract, configuration, missing-file |
| failed to create smartctl directory | exception | error | windows, filesystem, smartctl |
| - - see https://github.com/henrygd/beszel/issues/144 | exception | error | docker, podman, memory-stats |
| battery tag not returned | error_code | warning | windows, hardware, battery, device-io |
| container inspect request failed | http | error | http, podman, docker-socket |
| release checksum mismatch: expected | validation | critical | checksum, integrity, security, download, self-update |
| client not initialized | exception | error | ssh, lifecycle, race-condition |
| no sensors found (try running as admin with LHM=true) | error_code | warning | windows, sensors, admin-privileges, lhm |
| chcon failed | exception | warning | selinux, security, permissions, linux |
| no SELinux tools available (semanage/restorecon or chcon) | exception | warning | selinux, security, linux, missing-tool |
| hash mismatch: got want | validation | error | go, hash-mismatch, checksum-verification, security |
| temperature collection timed out | error_code | warning | timeout, sensors, temperature, gopsutil |
| no valid GPU data found | exception | warning | gpu, collector, no-data |
| ( ) failed to fetch latest releases | http | error | network, http, github-api, rate-limit |
| invalid file path | validation | warning | path-traversal, security, validation, archive |
| ( ) failed to send download file request | http | error | network, http, download, github-api |
| failed to decode response | exception | error | ssh, cbor, deserialization, agent |
| invalid container id | validation | error | validation, security, docker |
| unsupported release digest algorithm | validation | error | checksum, algorithm, sha256, self-update |
| must set TOKEN or TOKEN_FILE | validation | critical | configuration, authentication, token, environment |
| failed to unmarshal generic response data | exception | error | cbor, schema-mismatch, versioning |
| hub not verified | error_code | warning | authentication, handshake, security, hub |
| no GPU found - see https://beszel.dev/guide/gpu | exception | warning | gpu, configuration, agent |
| unexpected dest type for GetData: %T | exception | error | type-mismatch, legacy-compat, programming-error |
| container info request failed | http | error | http, docker-api, container-inspect |
| logs request failed | http | error | http, docker-logs, stream |
| timeout | exception | error | ssh, timeout, network |
| log frame size ( ) exceeds maximum ( ) | exception | warning | stream-parsing, memory-safety, docker-logs |
| no configured GPU collectors are available | exception | error | gpu, configuration, env-var |
| docker version request failed | http | error | http, docker, version-check |
| failed to find systems collection | exception | error | pocketbase, database, migration, config |
| returned negative bytes | exception | warning | go, file-io, defensive-programming |
| data directory not found | error_code | error | filesystem, configuration, data-directory, permissions |
| failed to encode request | exception | error | ssh, cbor, serialization |
| battery capacity unknown | error_code | warning | windows, hardware, battery, invalid-data |
| fingerprint mismatch | error_code | error | authentication, fingerprint, security, token-reuse |
| failed to rename the current executable | exception | error | self-update, filesystem, rename, permissions |
| invalid token | error_code | error | authentication, universal-token, validation, hub |
| failed to create temp directory | exception | error | windows, sensors, filesystem, temp-directory |
| failed to parse config.yml | exception | error | yaml, config, validation |
| fingerprint file is empty | error_code | error | filesystem, fingerprint, empty-file |
| service name is required | validation | warning | validation, systemd, request-payload, cbor |
| rename | exception | error | go, filesystem, rename, installation |
| close tmp | exception | error | filesystem, download, build-tool |
| systemd manager unavailable | error_code | error | systemd, platform, linux, stub |
| unexpected dest type for GetSmartData: %T | exception | error | type-mismatch, legacy-response, smart-data |
| failed to create update data directory | exception | error | filesystem, permissions, mkdir, configuration |
| HUB_URL environment variable not set | validation | critical | configuration, environment, websocket, startup |
| scanner error | exception | error | gpu, scanner, io |
| no websocket connection | error_code | error | websocket, network, connectivity, hub |
| invalid SHA-256 release digest | validation | error | checksum, sha256, hex, digest-format |
| unexpected dest type for GetContainerInfo: %T | exception | error | type-mismatch, legacy-compat, programming-error |
| failed to create new system | exception | error | pocketbase, database, validation, config |
| failed to open release for checksum verification | exception | error | filesystem, file-open, checksum, permissions |
| write tmp | exception | error | network, filesystem, download |
| failed to create update directory | exception | error | filesystem, permissions, tempdir, self-update |
| failed to write embedded smartctl | exception | error | windows, filesystem, smartctl |
| unexpected dest type for GetContainerLogs: %T | exception | error | type-mismatch, legacy-compat, programming-error |
| unexpected dest type for CheckFingerprint: %T | exception | error | type-mismatch, legacy-compat, programming-error |
| no key provided: must set -key flag, KEY env var, or… | validation | error | go, configuration, ssh, missing-env-var |
| no matching fingerprints | error_code | error | authentication, fingerprint, token, hub |
| unexpected arcstats size format | exception | warning | go, zfs, procfs, parsing |
| create dir | exception | error | filesystem, build-tool, download |
| new request | exception | error | http, url, build-tool |
| returned status | http | error | go, http, healthcheck, status-code |
| system exists | error_code | warning | go, duplicate-key, system-manager, state |
| failed to calculate release checksum | exception | error | filesystem, io, checksum, disk |
| missing asset containing | error_code | error | self-update, github-release, assets, platform |
| nvmlInit failed | exception | error | gpu, nvidia, nvml, driver |
| failed to send request | exception | error | websocket, network, send-failure |
| unsupported hash length | validation | error | checksum, validation, build-tool |
| unexpected HTTP status | http | error | http, download, build-tool |
| failed to load | exception | error | gpu, nvidia, nvml, dynamic-library |
| no sysfs values found | exception | warning | gpu, linux, sysfs, intel |
| open tmp | exception | error | filesystem, download, build-tool |
| http get | exception | error | network, http, download |
| failed to read key file | exception | error | go, configuration, file-io, ssh, permissions |
| error parsing URL | exception | error | go, url-parsing, alerts, shoutrrr |
| SSH disabled | error_code | error | ssh, configuration, env-var, startup |
| nvml not supported on this platform | exception | warning | gpu, nvidia, platform, build |
| no system data in response | exception | error | go, protocol, deserialization, legacy-agent |
| unsupported action | exception | error | unsupported-action, legacy-response, version-skew |
| failed to delete from | exception | error | database, sqlite, retention, delete |
| panic | panic | warning | sensors, panic, gopsutil, temperature |
| unknown action | exception | error | websocket, protocol, version-skew, agent |
| failed to delete old systemd service records | exception | error | database, sqlite, retention, systemd |
| unexpected dest type for GetSystemdInfo: %T | exception | error | type-mismatch, legacy-response, systemd |
| timeout creating session | error_code | error | go, ssh, timeout, network |
| ${resp.Error} | error_code | error | go, ssh, agent, remote-error |
| no SMART data in response | exception | warning | go, smart, disks, legacy-agent |
| no info in response | exception | error | go, docker, container-info, legacy-agent |
| no logs in response | exception | error | go, docker, container-logs, legacy-agent |
| failed to delete old container records | exception | error | database, sqlite, retention, containers |
| nvmlDeviceGetCount failed | exception | error | gpu, nvidia, nvml, driver |
| no fingerprint in response | exception | error | go, protocol, fingerprint, legacy-agent |
| size field not found in arcstats | exception | warning | go, zfs, procfs, missing-field |
| system not found | error_code | warning | go, not-found, system-manager, state |