henrygd/beszel
62.7
Adequate · 10 October 2026
49.3k
lines of production code
Go
with TypeScript
5
measurements over time
What this system is
Beszel is a self-hosted system monitoring hub that collects and visualizes metrics from remote agents across Linux, Windows, and macOS environments. It tracks core hardware resources, container health, storage subsystems like ZFS and Btrfs, and network connectivity, while providing configurable alerting and external status page integration. The system features a modern web interface for managing multiple systems, viewing detailed performance charts, and configuring monitoring rules.
How it got here
2024–2025 — architecture overhaul and monitoring expansion
64 changes.
The project underwent a significant structural reorganization, splitting the hub and agent into distinct binaries and modernizing the build system and frontend stack. This period introduced extensive new monitoring capabilities, including systemd, ZFS, Btrfs, multi-battery, and network health tracking, alongside a redesigned user interface with comprehensive localization support.
2026 — ZFS monitoring and Kubernetes support
11 changes.
This period focused on expanding system monitoring capabilities with new ZFS data collection and Wi-Fi signal tracking, alongside a comprehensive overhaul of the system charts UI. It also introduced official Helm charts for Kubernetes deployment and standardized hub-agent communication through unified transport interfaces.
Features
Add S.M.A.R.T. data parsing and entity definitions
The system now includes initial support for parsing S.M.A.R.T. (Self-Monitoring, Analysis and Reporting Technology) data from storage devices. This change introduces the \internal/entities/smart\ package, which defines Go structs for mapping \smartctl\ JSON output, including device info, status, capabilities, and ATA/NVMe smart attributes. It also implements custom JSON unmarshaling for raw values to handle various formats, such as duration strings (e.g., "62312h+33m+50.907s") and parenthetical representations, ensuring accurate extraction of metrics like temperature and power-on time. Tests are included to verify the correct parsing of these edge cases.
internal/entities/smart · high confidence
Add systemd service monitoring data model
Introduces the internal data structures and parsing logic for monitoring systemd services, including types for service states (active, inactive, failed, etc.) and sub-states. The new \Service\ entity tracks CPU and memory usage, featuring a method to calculate CPU percentage based on time deltas and core counts, while also maintaining peak usage metrics. This provides the foundational model for reporting systemd service health and resource consumption.
internal/entities/systemd · high confidence
Add systemd service monitoring table
A new table component has been added to display systemd service status, including columns for name, state, sub-state, CPU usage (10m average and peak), memory usage (current and peak), and last updated time. The table supports sorting, filtering, and global search across service names and statuses, with visual indicators for service health (green for active/running, red for failed, yellow for dead). Data is fetched from the 'systemd\_services' collection and refreshed periodically or upon system updates.
internal/site/src/components/systemd-table · high confidence
Added Croatian (hr) language support
The application now includes a complete Croatian translation file (hr.po), enabling users to switch their interface language to Croatian. This update adds translations for core UI elements, system monitoring labels, alert notifications, and settings pages, ensuring the product is fully localized for Croatian-speaking users.
internal/site/src/locales/hr · high confidence
Added Hebrew (he) locale support
Users can now view the interface in Hebrew. This change introduces the initial Hebrew translation file (he.po) for the site, providing translations for core UI elements such as system information, alerts, settings, and navigation labels.
internal/site/src/locales/he · high confidence
Added Hungarian language support
The application now includes a complete Hungarian translation file (hu.po), enabling users to view the interface in Hungarian. This update covers UI strings for system monitoring, alerts, settings, and navigation components.
internal/site/src/locales/hu · high confidence
Added Korean language support
Users can now view the interface in Korean. This change introduces the initial Korean translation file (ko.po) for the site, enabling localization for Korean-speaking users across various components such as system info, alerts, and settings.
internal/site/src/locales/ko · high confidence
Added Norwegian (no) locale translations
The application now supports Norwegian (no) for its user interface. This change introduces the \no.po\ translation file containing localized strings for system information, alerts, settings, and navigation elements, enabling Norwegian-speaking users to interact with the site in their native language.
internal/site/src/locales/no · high confidence
Added Polish language support
The application now includes a complete Polish translation file (pl.po), enabling users to view the interface in Polish. This update adds translations for core UI elements, system monitoring labels (such as CPU cores, threads, and disk I/O), time intervals, and alert history components.
internal/site/src/locales/pl · high confidence
Added Portuguese (pt) locale translations
Users can now see the interface in Portuguese. This change introduces the initial Portuguese translation file (pt.po) for the site, covering UI strings for system monitoring, alerts, settings, and navigation components.
internal/site/src/locales/pt · high confidence
Added Russian language support
The application now includes a Russian (ru) locale, enabling users to view the interface in Russian. This update adds translations for core UI elements, system metrics (such as CPU cores, threads, and disk I/O), time durations, and navigation labels, ensuring the site is accessible to Russian-speaking users.
internal/site/src/locales/ru · high confidence
Added Serbian (Cyrillic) language support
Users can now view the interface in Serbian (Cyrillic). This change introduces the initial translation file (sr.po) for the Serbian locale, enabling localization for UI elements across the site.
internal/site/src/locales/sr · high confidence
Added Simplified Chinese (zh-CN) translations
The application now supports Simplified Chinese. A new locale file (zh-CN.po) has been added, providing translations for core UI elements including system monitoring metrics (CPU cores, threads, disk I/O, load averages), navigation labels, settings pages (alerts, quiet hours, general display), and container management views.
internal/site/src/locales/zh-CN · high confidence
Added Traditional Chinese (zh-TW) localization
The site now supports Traditional Chinese (zh-TW) for the user interface. This change adds the \zh.po\ translation file to the \internal/site/src/locales/zh\ directory, enabling Chinese-speaking users to see interface elements such as navigation, settings, alerts, and system information in their language.
internal/site/src/locales/zh · high confidence
Added Uzbek (uz) language support
The application now includes a new Uzbek translation file (uz.po), enabling users to switch their interface language to Uzbek. This addition provides translations for core UI elements, including system monitoring metrics (such as cores, threads, and time durations), navigation labels, and settings options, sourced via Crowdin.
internal/site/src/locales/uz · high confidence
Agent CLI gains fingerprint and health commands with flexible authentication options
The agent now supports \fingerprint\ (to view or reset the agent's unique identifier) and \health\ (to check if the agent is running) as direct subcommands. Authentication is more flexible, accepting the SSH public key via the \-key\ flag, the \KEY\ environment variable, or a file path specified by the \KEY\_FILE\ environment variable. Users can also configure the hub connection using \--url\ and \--token\ flags, and the agent exits cleanly with code 0 on Windows if no key is provided, preventing validation errors with package managers like Winget.
internal/cmd/agent · high confidence
Automatic system synchronization from config.yml
The hub now automatically syncs monitored systems defined in the local \config.yml\ file with the application database. When the hub starts, it reads the configuration to create, update, or delete system records, handling user email-to-ID resolution and preserving existing fingerprint tokens unless a new one is explicitly provided in the config. This allows users to manage their system inventory declaratively via a YAML file rather than solely through the UI.
internal/hub/config · high confidence
Expanded system monitoring with systemd, ZFS, and multi-battery support
The system data model has been extended to support new monitoring capabilities. Users can now track the status of systemd services, including detecting failed services which are surfaced in the All Systems table. ZFS pool metrics (capacity, health, I/O) are now collected and displayed. Additionally, the system now supports monitoring multiple batteries (reporting per-battery status) and a representative main battery, with robust JSON encoding to ensure compatibility across library versions. The data structures also include fields for fan RPMs, detailed GPU power usage, and cumulative disk I/O totals.
internal/entities/system · high confidence
German localization file added
A new German translation file (de.po) has been added to the site's locale directory, providing German translations for UI strings across components such as alerts, system info, and settings.
internal/site/src/locales/de · high confidence
Indonesian language support added
The application now includes Indonesian (id) translations, allowing users to view the interface in their native language. This update adds comprehensive localization strings for system monitoring, alerts, settings, and navigation components.
internal/site/src/locales/id · high confidence
Initial Debian packaging for the Beszel Agent
This change introduces the complete set of Debian package build files for the Beszel Agent, enabling installation via .deb packages on Debian-based systems. The package includes a systemd service unit (\beszel-agent.service\) that runs the agent as a dedicated \beszel\ user with strict security sandboxing (e.g., \ProtectSystem=strict\, \LockPersonality=yes\). The post-installation script (\postinstall.sh\) automatically creates the system user and group, optionally adds the user to the \docker\ group if it exists, generates a secure configuration file at \/etc/beszel-agent.conf\, and handles the initial SSH key configuration via debconf. Supporting files include copyright, lintian overrides, and standard Debian maintainer scripts (\prerm.sh\, \postrm.sh\) to manage service lifecycle and configuration cleanup.
supplemental/debian · high confidence
Initial English locale file added
The English translation file (en.po) has been added to the site's locale directory, providing the base set of user-facing strings for the interface. This includes translations for system information displays (cores, threads, time durations), navigation labels (Admin, All Systems, Alerts), and settings pages (heartbeat, quiet hours, alerts history).
internal/site/src/locales/en · high confidence
Initial release of Beszel Hub and Agent Helm charts
This change introduces the first official Helm charts for deploying Beszel Hub and the Beszel Agent in Kubernetes environments. The Beszel Hub chart provides a Deployment with configurable persistent storage, service exposure via Ingress or HTTPRoute, and autoscaling support. The Beszel Agent chart offers flexible deployment as either a DaemonSet (default, one pod per node) or a single Deployment, with support for GPU monitoring, host network access, and authentication via SSH keys or existing secrets. Both charts are published as OCI artifacts to GitHub Container Registry (ghcr.io) and include comprehensive documentation, validation hooks, and test templates.
supplemental/helm · high confidence
Introduce ZFS data entity model for agent-hub communication
A new Go package (internal/entities/zfs) defines the data structures exchanged between the agent and the hub for ZFS monitoring. This includes ZfsData, PoolDetail, Scrub, Vdev, and Dataset types, enabling the system to report pool health, capacity, scrub status, vdev errors, and dataset usage. The model also supports Btrfs backends (identified by 'b:' prefix) and tracks backend completion status to handle partial inventory failures gracefully.
internal/entities/zfs · high confidence
Introduce outbound heartbeat monitoring and network monitor data structures
Users can now configure an outbound heartbeat (via HEARTBEAT\_URL) to periodically ping an external endpoint (e.g., BetterStack, Uptime Kuma) with Beszel's system status, enabling external monitoring without exposing the application. Additionally, the system now supports network monitoring tasks (ICMP, TCP, HTTP, DNS) with detailed result structures including response times, packet loss, and TLS certificate expiry information, laying the groundwork for agent-based network health checks.
github.com/henrygd/beszel · high confidence
Introduce thread-safe ExpiryMap with TTL-based expiration and background cleanup
The internal/hub/expirymap package now provides a generic, thread-safe map that automatically expires entries based on a time-to-live (TTL). Users can store values with specific expiration times, and the map supports lazy cleanup on access as well as a configurable periodic background cleaner that can be explicitly stopped via StopCleaner. The implementation includes methods for setting, getting, removing, and updating expiration times, along with utility methods like GetByValue and RemovebyValue, ensuring efficient memory management for cached data within the hub.
internal/hub/expirymap · high confidence
Monitor connected Wi-Fi signal strength per interface
The agent now reports the current Wi-Fi connection status (SSID) and signal strength (RSSI in dBm) for the active interface on Linux, macOS, and Windows. This feature collects data only for currently associated stations—skipping background scans—and stores compact RSSI statistics. On Linux, it uses nl80211 to query station info directly, skipping collection if no wireless devices are registered. On macOS, it uses CoreWLAN via JXA, and on Windows, it uses the native WLAN API, labeling interfaces by adapter name. Collection can be disabled entirely by setting the SKIP\_WIFI environment variable.
agent/wifi · high confidence
New UI component library added
A new set of UI components has been added to the site, including alert dialogs, alerts, badges, buttons, cards, charts, checkboxes, collapsibles, command palettes, dialogs, dropdown menus, icons, input fields, labels, OTP inputs, and select menus. These components provide a consistent and accessible user interface for the application.
internal/site/src/components/ui · high confidence
New ZFS monitoring capability in the agent
The agent now includes a new \agent/zfs\ package that collects ZFS pool and dataset statistics. On Linux, it reads pool health, capacity, and cumulative I/O counters directly from the kernel's procfs interfaces (\/proc/spl/kstat/zfs\), supporting both legacy and OpenZFS 2.3+ counter formats, and exposes the ARC size. On FreeBSD, it retrieves the ARC size via sysctl, while pool-level kernel stats are unsupported. On all platforms, it uses \zpool\ and \zfs\ CLI utilities to gather pool health, capacity, dataset usage, and detailed pool status (including scrub progress and vdev error counts). The implementation includes platform-specific handling for \/dev/zfs\ availability and comprehensive test coverage for parsing logic and counter sources.
agent/zfs · high confidence
New agent utility package for environment, file, and path helpers
The agent now includes a dedicated \utils\ package that centralizes common helper functions. This provides a new \GetEnv\ function that checks for environment variables with a \BESZEL\AGENT\\ prefix before falling back to the unprefixed key, and introduces \ReadStringFileLimited\ to safely read files with a maximum size limit, including a safety check for negative byte returns to prevent panics on misreported pseudo-file sizes. Additionally, \LookPathHomebrew\ is added to locate executables in Homebrew paths on macOS and Linux, and standard conversion utilities like \BytesToMegabytes\ and \BytesToGigabytes\ are provided for consistent unit handling.
agent/utils · high confidence
New alerts management interface with system-specific and global configuration
Users can now manage alert rules directly from the site via a new Alerts button and sheet component. This interface allows configuring alerts for individual systems or globally across all systems, supports copying alert configurations between systems, and provides a UI for creating, updating, and deleting alert rules via the backend API.
internal/site/src/components/alerts · high confidence
New automated installation and upgrade scripts for Beszel Agent and Hub
This release introduces a comprehensive suite of new installation and upgrade scripts for the Beszel Agent and Hub, significantly expanding platform support and simplifying deployment. The new \install-agent.sh\ script now supports Linux (including Alpine, OpenWrt, and glibc systems), FreeBSD, and OPNsense, featuring automatic SELinux context management, architecture detection (including mips/mipsle), and robust error handling. Windows users benefit from a new \install-agent.ps1\ script that supports Scoop, WinGet, and manual installation methods, with optional firewall configuration and admin privilege handling. A new \install-agent-brew.sh\ script enables one-click Homebrew installation on macOS. Additionally, \install-hub.sh\ provides automated Hub installation with FreeBSD support, and new \upgrade-agent.ps1\ and \upgrade-agent-wrapper.ps1\ scripts allow for seamless Windows agent upgrades.
supplemental/scripts · high confidence
New containers table with detailed metrics and filtering
The containers view has been replaced with a new table component that displays detailed container information including CPU, memory, network usage, health status, ports, and Docker image names. The table supports sorting, global filtering across multiple fields (name, system, status, image, ports), and column visibility toggling. It automatically hides the ports column when no containers have ports exposed, and includes a clear button for the filter input. The table fetches data from the backend and updates when systems change, providing a more comprehensive view of container status and resource usage.
internal/site/src/components/containers-table · high confidence
New dedicated routes for system monitoring sections
The application now includes dedicated route components for the Home (All Systems), Containers, Network Monitors, and S.M.A.R.T. pages, each rendering their respective tables and active alerts. The System Detail route has been refactored to use a tabbed layout (Core, Network, Disk, GPU, Containers, Services) that conditionally displays charts and tables based on available data and agent version, improving navigation and organization of system metrics.
internal/site/src/components/routes · high confidence
New generic delta tracker for calculating value differences over time
A new \deltatracker\ package has been added to the agent, providing a thread-safe, generic utility for tracking changes in numeric values (integers and floats) across time intervals. This component allows the system to record current values, cycle through intervals, and calculate the difference (delta) between the current and previous states for specific keys or across all tracked items. It includes comprehensive tests covering various numeric types and edge cases, ensuring reliable calculation of deltas for monitoring or state-tracking purposes.
agent/deltatracker · high confidence
New hardware monitoring agent using LibreHardwareMonitor
A new agent implementation has been added for the agent/lhm location, introducing a C\# application that utilizes the LibreHardwareMonitor library to read system sensor data. This component listens for 'getTemps' commands, queries enabled hardware components (CPU, GPU, memory, motherboard, storage), filters out non-temperature or invalid sensors, and outputs formatted temperature readings. This change establishes the core logic for hardware telemetry collection in this specific agent module.
agent/lhm · high confidence
New monitoring and alerting capabilities for systems and networks
The site's internal library now supports a significantly expanded set of monitoring metrics and alert types. Users can now configure alerts for GPU usage, temperature sensors, battery charge levels, and systemd service failures, in addition to existing CPU, memory, and disk alerts. The library also introduces network monitoring utilities, including TLS certificate expiry checks and loss/responsiveness tracking, alongside new enums for container health and connection types (SSH/WebSocket). These changes enable the UI to display and alert on a broader range of system and network health indicators.
internal/site/src/lib · high confidence
New multi-battery monitoring with cross-platform support
The agent now includes a dedicated battery package that detects and reports on all available batteries (system and peripheral) across Linux, macOS, and Windows. This change introduces multi-battery monitoring, ensuring that stats are sent even if some batteries are missing data, and handles edge cases like invalid UTF-8 in firmware names or ghost batteries with zero capacity. A primary battery is selected for summary metrics based on reported full-charge capacity, system scope, and name, providing more accurate and robust battery status reporting for users.
agent/battery · high confidence
New network monitors table with bulk import and TLS configuration
The network monitors table has been replaced with a new implementation that supports bulk importing monitors via CSV, allows configuring custom DNS servers for DNS monitors, and enables skipping TLS certificate verification for HTTPS monitors. The new dialog validates inputs (e.g., rejecting IP addresses for DNS targets) and normalizes HTTP targets, while the table view displays protocol-specific badges including an indicator for insecure TLS connections.
internal/site/src/components/network-monitors-table · high confidence
Outbound heartbeat monitoring for external status pages
The hub now supports periodic outbound health checks to external monitoring endpoints (such as BetterStack, Uptime Kuma, or Healthchecks.io) via the new HEARTBEAT\_URL environment variable. When configured, the hub sends HTTP requests at a configurable interval (HEARTBEAT\_INTERVAL) using a specified method (HEARTBEAT\_METHOD, defaulting to POST) to report the current status of all managed systems, including counts of up/down/paused systems and any triggered alerts. This allows operators to monitor the health of their Beszel instance from external dashboards without exposing the hub to the public internet.
internal/hub · high confidence
Redesigned hub interface with new components and system management
The site's component library has been rebuilt to support a modernized hub interface. This includes a new active alerts display, a dedicated command palette for quick navigation, and a redesigned system addition dialog with tabs for Docker and Binary installation methods. The UI now features a command palette for searching systems and settings, a footer that displays the current version and available updates, and a theme provider that respects system preferences. Additionally, the router has been updated to support base paths, and the navbar now includes tooltips and mobile-optimized navigation.
internal/site/src/components · high confidence
Redesigned system dashboard with tabbed navigation and detailed metric sheets
The system route has been refactored to use a tabbed layout (Core, Disk, etc.) with lazy-loaded tables for containers, S.M.A.R.T. devices, ZFS/Btrfs storage pools, systemd services, and network monitors. System information is now displayed in a dedicated info bar that pulls detailed metadata (hostname, kernel, CPU model, memory) from a new system\_details collection. Charting capabilities have been expanded with new sheets for CPU usage (including per-core breakdowns and time-state stacking) and disk I/O (showing throughput, utilization, await, and cumulative totals). Network monitoring now includes per-interface and cumulative download/upload charts, with legends hidden when more than 15 interfaces are present. The UI also introduces a reusable chart card component with filtering, average/max toggling, and intersection-observer-based lazy rendering.
internal/site/src/components/routes/system · high confidence
Settings page restructured with new monitoring and configuration capabilities
The Settings interface has been reorganized into a sidebar-based layout with dedicated sub-pages. Users can now configure general preferences (language, layout width, chart time, units) and manage notifications (email, Shoutrrr webhooks, and quiet hours). A new Heartbeat Monitoring section allows administrators to configure and test outbound pings to external services. Additionally, a YAML Configuration page enables admins to export the current system configuration, and the Tokens & Fingerprints page now displays the public key for universal tokens and supports making tokens permanent.
internal/site/src/components/routes/settings · high confidence
Slovenian language support added
The application now includes a Slovenian (sl) locale file, enabling users to view the interface in Slovenian. This update adds translations for core UI elements, system monitoring metrics (such as CPU cores, threads, and disk I/O), alert history, and settings pages.
internal/site/src/locales/sl · high confidence
Architecture
Project restructure and build system overhaul
The repository has been reorganized to separate the hub and agent into distinct binaries, moving application code into the /internal directory and renaming the main entry point from main.go to beszel.go. A new Makefile and .goreleaser.yml configuration now automate the build process, enabling cross-platform compilation for Linux, Windows, macOS, and FreeBSD, including specific support for ARM architectures (v5, v6, v7) and a separate glibc build for Linux amd64. The project also introduces a formal MIT license, a security policy, and updated Docker ignore rules to streamline production builds.
(repo-wide) · high confidence
Behavioural changes
Agent architecture refactored with new caching and connection management
The agent's internal structure has been reorganized to improve reliability and performance. A new system data cache (agent\_cache.go) now stores collected metrics, reducing redundant system calls by serving fresh data based on configurable intervals. Connection handling has been consolidated into a dedicated ConnectionManager (connection\_manager.go) that manages both WebSocket and SSH connections, including automatic reconnection logic and state tracking. Additionally, a new Btrfs filesystem collector (btrfs/) has been added to monitor Btrfs storage pools, reporting health status, device states, and I/O statistics for Linux systems.
agent · high confidence
Agent health check now prefers /dev/shm on Linux
The agent's health status mechanism has been updated to store its health file in the shared memory directory (/dev/shm) on Linux systems when available, falling back to the standard temporary directory on other platforms. This change improves reliability and performance by avoiding disk I/O for the health timestamp file, which is used to determine if the agent is considered healthy based on a 90-second connection window.
agent/health · high confidence
Alerts subsystem restructured into internal package with new alert types and caching
The alert management logic has been moved from the hub package into a dedicated internal/alerts package, introducing an in-memory cache to optimize alert state lookups and reduce database load. This change adds support for new alert types including Container Health (with log excerpts), multi-battery monitoring, and ZFS pool status, while also implementing quiet hours to silence notifications during specific time periods. The alert API endpoints for creating, updating, and deleting user alerts have been refined to support multi-system operations and improved validation, and security measures have been strengthened to prevent non-admin users from sending test notifications to internal services.
internal/alerts · high confidence
Database schema updates for version 0.20.0
This release includes database migrations to support new monitoring capabilities. The \network\_monitors\ collection gains a \certInfo\ JSON field for TLS certificate details, a \server\ text field, and a \skipTlsVerify\ boolean to allow ignoring TLS errors. The \zfs\_pools\ collection adds a \status\ text field to surface ZFS pool health information. Additionally, the \alerts\ collection schema is updated to include new metric types such as \NetworkMonitorLoss\ and \ContainerHealth\.
internal/migrations · high confidence
Enhanced container monitoring with health status, image details, and accurate CPU/network metrics
The container entity now includes health status, image name, and port information, allowing users to see container health states (healthy, unhealthy, starting) and exposed ports directly in the monitoring data. CPU usage calculation has been improved to handle counter resets and supports time-based calculations for Podman containers, ensuring accurate metrics even when underlying counters behave unexpectedly. Network statistics have been upgraded from megabytes to bytes for greater granularity, and the system now tracks whether a Docker image update is available.
internal/entities/container · high confidence
Hub service initialization and health check command
The hub entry point has been moved to internal/cmd/hub and now initializes the PocketBase application with specific configuration, including the addition of an 'update' command for version upgrades and a 'health' command to verify the service status via an HTTP endpoint.
internal/cmd/hub · high confidence
Introduces secure SSH defaults and a unified WebSocket protocol for agent communication
The internal common package now enforces strict, secure defaults for SSH connections by restricting key exchanges, MACs, and ciphers to modern algorithms (e.g., curve25519-sha256, chacha20-poly1305). Additionally, a new WebSocket action interface and request/response structures are defined to standardize hub-agent communication, supporting actions such as retrieving system data, container logs, SMART drive info, systemd service details, and ZFS data, while maintaining backward compatibility with legacy data formats.
internal/common · high confidence
New site source structure and UI theme configuration
The site source code has been reorganized into a new \internal/site/src\ directory, establishing the entry point (\main.tsx\) and type definitions (\types.d.ts\) for the web interface. A new global stylesheet (\index.css\) introduces a Tailwind-based design system with explicit light and dark mode color palettes, custom breakpoints, and specific UI adjustments such as increased chart tooltip z-index and non-centered dialog headings.
internal/site/src · high confidence
Refactored WebSocket agent communication with a new request manager
The internal/hub/ws package has been refactored to use a dedicated RequestManager for handling concurrent requests to agents. This change introduces a new request-response pattern where requests are tracked by unique IDs and routed to the correct handler, replacing the previous ad-hoc approach. The new system supports both legacy and new response formats, ensuring backward compatibility with older agents. A new fingerprint authentication mechanism has been added, allowing agents to authenticate using SSH signatures. The WebSocket connection handling has been updated to use a singleton upgrader and includes improved connection lifecycle management with automatic cleanup of pending requests.
internal/hub/ws · high confidence
Refactored charting system with new reusable components and hooks
The charts module has been refactored to use new, reusable React components (\AreaChartDefault\, \LineChartDefault\) and utility hooks (\useContainerChartConfigs\, \useYAxisWidth\, \useContainerDataPoints\, \useNetworkInterfaces\). This change introduces a \ChartTimeSelect\ component that dynamically filters available time ranges based on the connected agent's version, and adds support for dual Y-axes in line charts (allowing metrics like loss % on a right axis). The refactoring also improves performance by reducing chart redraws via intersection observers and enhances container metric visualization with dynamic color generation and filtering capabilities.
internal/site/src/components/charts · high confidence
Removed legacy collections snapshot migration
The migration file defining the initial database schema for the 'users', 'systems', 'system\_stats', and 'container\_stats' collections has been deleted. This removes the automatic creation of these data structures during application startup, implying that the schema is now managed by other means or that these collections are no longer part of the application's data model.
migrations · high confidence
Reorganized Dockerfiles into internal/ and added slim NVIDIA agent image
The project has reorganized its build artifacts, moving Dockerfiles from the root directory into the internal/ folder (e.g., internal/dockerfile\_agent, internal/dockerfile\_hub). This change introduces a new 'slim' NVIDIA agent image (internal/dockerfile\_agent\_nvidia\_slim) that uses a distroless base to reduce size while still including smartmontools and ZFS utilities. The standard NVIDIA agent image now builds smartmontools from source to ensure compatibility, and all agent images include AMD GPU ID lookups and volume persistence for /var/lib/beszel-agent.
internal · high confidence
Secure self-update with checksum verification and extraction safeguards
The internal self-update mechanism now verifies the SHA-256 checksum of downloaded release assets before proceeding, rejecting archives with invalid or mismatched digests. Additionally, the archive extraction logic enforces path containment to prevent directory traversal attacks, ensuring that extracted files remain within the designated destination directory. On SELinux-enabled systems, the updater automatically applies the correct binary context after replacement to maintain proper access controls.
internal/ghupdate · high confidence
Site build tooling and configuration overhaul
The internal site build environment has been reconfigured to use Biome 2.2.4 for linting and formatting, replacing the previous setup with a new biome.json and .prettierrc. The project now uses a text-based bun.lock file and a new Vite configuration (vite.config.ts) that integrates React, Tailwind CSS, and Lingui i18n plugins. TypeScript configuration has been updated to use ES2022 targets and bundler module resolution, with the deprecated baseUrl property removed. The Go embed directive in embed.go now targets the dist directory, and index.html has been updated to include a crossorigin attribute for the manifest link, an apple-touch-icon, and a noindex meta tag.
internal/site · high confidence
System charts page receives a comprehensive UI and data overhaul
The system charts page has been refactored to improve layout, add new metrics, and fix existing display issues. The layout now uses tabs to organize system and major frontend charts, with specific spacing adjustments to prevent tooltip overflow. New monitoring capabilities include Wi-Fi signal strength charts for connected interfaces, multi-battery charge tracking, and cumulative disk read/write totals. GPU monitoring has been enhanced with a dedicated power draw chart and improved layout for usage/VRAM cards. Network monitoring charts now correctly display gaps for failed probes and disconnects, and packet loss is visualized with a red line. Several chart rendering bugs have been fixed, including the GPU power draw chart now rendering at the correct width, even y-axis ticks on system charts, and the temperature chart filtering logic. The Load Average chart is now conditionally rendered based on agent version.
internal/site/src/components/routes/system/charts · high confidence
Systems table view preferences and status filtering are now persisted
The systems table now remembers your column visibility, status filter (Up/Down/Paused), view mode (table/grid), and sort order across sessions. These preferences are saved to the server via user settings and fall back to local storage for offline or incognito use, ensuring a consistent experience when you return.
internal/site/src/components/systems-table · high confidence
Unified hub-agent communication via SSH and WebSocket transports
The hub now uses a unified \Transport\ interface to communicate with agents, supporting both SSH and WebSocket connections. This change introduces \SSHTransport\ as the single owner of each system's SSH connection, improving connection management and reliability. It also standardizes how agent responses are decoded into a new struct, ensuring consistent handling of data across both transport types. Additionally, the SSH transport includes improved cancellation handling to honor request timeouts and context cancellations, preventing hangs during network issues or agent unresponsiveness.
internal/hub/transport · high confidence
Updated Danish translations
The Danish language pack (da.po) has been updated with new translations and synchronization from the translation platform, ensuring UI strings for components like alerts, system info, and settings are current.
internal/site/src/locales/da · high confidence
Updated Dutch (nl) translations
The Dutch locale file has been updated with new translations for various UI strings, including system information labels (cores, threads, days), alert counts, and navigation items. This ensures the interface displays correctly in Dutch for users.
internal/site/src/locales/nl · high confidence
Updated French and Swedish locale files
The French (fr.po) and Swedish (sv.po) translation files in the site's locale directory have been updated with new strings and corrections, ensuring the interface displays correctly in these languages for users.
internal/site/src/locales/fr · high confidence
Updated Persian and Japanese locale files
The Persian (fa) and Japanese (ja) translation files have been updated with new strings and revisions, ensuring that interface elements such as system information, alert counts, and settings labels are correctly localized for users of these languages.
internal/site/src/locales/fa, internal/site/src/locales/ja · high confidence
Updated Spanish locale translations
The Spanish language pack (es.po) has been updated with new translations and corrections, ensuring the interface displays correctly in Spanish for users.
internal/site/src/locales/es · high confidence
Updated localization files for Czech, Italian, Turkish, Ukrainian, Vietnamese, and Traditional Chinese
The localization files in \internal/site/src/locales\ for Czech, Italian, Turkish, Ukrainian, Vietnamese, and Traditional Chinese have been updated with new translations. These updates ensure that interface strings for features such as alerts, system monitoring, and settings are correctly displayed in these languages.
(repo-wide) · high confidence
Fixes
Login page now supports redirect-based OAuth and fixes autofill issues
The login component now respects the \OAUTH\_DISABLE\_POPUP\ environment variable, allowing OAuth authentication to proceed via full-page redirect instead of a popup window when configured. Additionally, the login form's honeypot field has been renamed and autofill attributes adjusted to prevent interference with password managers like Bitwarden on Android, and the email validation schema now uses \rfcEmail\ to correctly support internationalized domain names (IDN/Punycode).
internal/site/src/components/login · high confidence
Test coverage
Added internal test helpers for API scenarios and Hub integration; Added tests for chart time settings, network monitor utilities, and time formatting; Added tests for record averaging, rollup, deletion, and WiFi monitoring logic; Added unit tests for the heartbeat service; Expanded test coverage for system monitoring and data handling.
Dependencies
Major dependency upgrades and Go version bump
The project has upgraded its Go runtime from version 1.22.4 to 1.27.1 and refreshed its Go dependencies, including significant updates to PocketBase (v0.22.16 to v0.40.4), gopsutil (v4.26.3 to v4.26.8), and shoutrrr (v0.21.0). The internal site dependencies have also been updated, notably upgrading React and React-DOM to version 19.1.2 and Tailwind CSS to 4.1.12.
(dependencies) · high confidence
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 62 → 63 (+0.2)
- Rubric changed (rubric-2026.09.15 → rubric-2026.10.5) — scores are not directly comparable.
Lenses
- Code Health 100 → 87 (-13.4)
- Architecture 97 → 99 (+2.4)
- Maturity 63 → 62 (-1.2)
- Readiness 61 → 60 (-1.4)
- Security 54 → 57 (+3.4)
Resolved (18)
- Critical CVE: [GHSA redacted] (internal/site/package-lock.json)
- High CVE: [GHSA redacted] (internal/site/bun.lock)
- High CVE: [GHSA redacted] (internal/site/package-lock.json)
- High CVE: [GHSA redacted] (internal/site/package-lock.json)
- High CVE: [GHSA redacted] (internal/site/bun.lock)
- High CVE: [GHSA redacted] (internal/site/bun.lock)
- High CVE: [GHSA redacted] (internal/site/bun.lock)
- High CVE: [GHSA redacted] (internal/site/bun.lock)
- High CVE: [GHSA redacted] (internal/site/bun.lock)
- High CVE: [GHSA redacted] (internal/site/bun.lock)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- Medium CVE: [GHSA redacted] (internal/site/bun.lock)
- Medium CVE: [GHSA redacted] (internal/site/bun.lock)
- Outdated: github.com/ebitengine/purego
- misleading comment (agent/lhm/beszel_lhm.cs)
- misleading comment (agent/lhm/beszel_lhm.cs)
New (327)
- Agent.gatherStats (cognitive 30) (agent/agent.go)
- Agent.gatherStats (cyclomatic 17) (agent/agent.go)
- Agent.getSystemStats (cognitive 39) (agent/system.go)
- Agent.getSystemStats (cyclomatic 17) (agent/system.go)
- Agent.initializeDiskInfo (cognitive 17) (agent/disk.go)
- Agent.newSensorConfigWithEnv (cognitive 17) (agent/sensors.go)
- Agent.refreshSystemDetails (cognitive 33) (agent/system.go)
- Agent.refreshSystemDetails (cyclomatic 22) (agent/system.go)
- Agent.sumAndTrackPerNicDeltas (cognitive 24) (agent/network.go)
- Agent.updateDiskIo (cognitive 35) (agent/disk.go)
- Agent.updateDiskUsage (cognitive 16) (agent/disk.go)
- Agent.updateTemperatures (cognitive 29) (agent/sensors.go)
- Agent.updateTemperatures (cyclomatic 20) (agent/sensors.go)
- AlertManager.HandleContainerAlerts (cognitive 44) (internal/alerts/alerts_container.go)
- AlertManager.HandleContainerAlerts (cyclomatic 20) (internal/alerts/alerts_container.go)
- AlertManager.HandleSystemAlerts (cognitive 202) (internal/alerts/alerts_system.go)
- AlertManager.HandleSystemAlerts (cyclomatic 95) (internal/alerts/alerts_system.go)
- AlertManager.IsNotificationSilenced (cognitive 27) (internal/alerts/alerts.go)
- AlertManager.SendAlert (cognitive 16) (internal/alerts/alerts.go)
- AlertManager.evaluateNetworkMonitorAlerts (cognitive 74) (internal/alerts/alerts_network_monitors.go)
- …and 307 more
Changes since last survey
- 117 commits — 61 feature/other, 56 fixes
By area
- internal/site — 51 commits
- internal/hub — 18 commits
- agent/disk.go — 7 commits
- agent/wifi — 6 commits
- (root) — 4 commits
- agent/agent.go — 4 commits
- agent/cpu.go — 3 commits
- agent/server.go — 2 commits
- agent/smart.go — 2 commits
- agent/test-data — 2 commits
- agent/zfs — 2 commits
- internal/alerts — 2 commits
- .github/workflows — 1 commit
- agent/client_test.go — 1 commit
- agent/connection_manager.go — 1 commit
- agent/cpu_linux.go — 1 commit
- agent/docker.go — 1 commit
- agent/gpu_intel.go — 1 commit
- agent/package_updates.go — 1 commit
- agent/systemd.go — 1 commit
Notable commits
- fix: Fix: Convert intel gpu top from text to JSON (#2387)
- fix: fix(agent): SKIP_GPU excludes GPU hwmon from temperatures and fans (#2313)
- fix: fix(agent): count ZFS snapshot reads in pool I/O stats (#2474)
- fix: fix(agent): create SSH server configuration per connection (#2451)
- fix: fix(agent): don't detect zypper-aptitude's apt-get wrapper as apt (#2523)
- fix: fix(agent): fall back to last-resort root when root key is taken
- fix: fix(agent): fix pacman update check under systemd sandbox
- fix: fix(agent): handle 32-bit wrap of disk I/O time counters (#2407)
- fix: fix(agent): handle partial NVMe SMART data (#2340)
- fix: fix(agent): improve WebSocket and SSH fallback handling (#2441)
- fix: fix(agent): keep Windows volume names intact when matching I/O devices (#2419)
- fix: fix(agent): keep reconnecting after an async WebSocket handshake failure (#2329, #2326)
- fix: fix(agent): measure first disk I/O sample of an interval from the full baseline (#2420)
- fix: fix(agent): prevent network counter underflow on interface removal and container restart (#2574)
- fix: fix(agent): promote existing entry when root key is already registered
- fix: fix(agent): report LXC guest CPU usage from cgroup accounting (#2341)
- fix: fix(agent): reset host CPU baseline after counter rollback
- fix: fix(agent): resolve device symlinks so LVM volumes map to disk I/O (#2486)
- fix: fix(agent): skip first disk I/O sample of an interval when its window is too short
- fix: fix(agent): stop sending legacy hubs a duplicate stats payload (#2529)
- …and 97 more
Architecture
- 1 containers · 1 bounded contexts · 0 dependency edges (baseline)
Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
henrygd/beszel was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 10 October 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 13bdd05934a7363016aa9a92c0d5bef13c0e81a4 — the exact code this score is about.
- Scored under rubric-2026.10.5 — the same rubric and the same method as every other entry in this index.
- Measured by watchdog.canine.dev using codehealth-analyzer preprod-fe8540b5da9b.