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