Beszel Agent

Lightweight server monitoring agent

Alternative to: grafana, netdata, prometheus, zabbix

Beszel Agent is the lightweight monitoring agent that runs on each of your servers and reports system metrics, Docker statistics, and historical data back to the Beszel hub.

Beszel Agent Docker Compose example

Self-host Beszel Agent on your own server, homelab, or VPS starting from this Docker Compose example. It runs Beszel Agent in Docker containers using the official henrygd/beszel-agent:latest image, with persistent volumes and automatic restarts preconfigured. Review the environment variables and adjust them to your setup, save the file as compose.yml (or docker-compose.yml), and start the stack with docker compose up -d.

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    environment:
      LISTEN: "45876"
      KEY: ""
      HUB_URL: "changeme"
      TOKEN: ""
    volumes:
      - beszel_agent:/var/lib/beszel-agent
      - /var/run/docker.sock:/var/run/docker.sock:ro
      # monitor other disks / partitions by mounting a folder in /extra-filesystems
      # - /mnt/disk1/.beszel:/extra-filesystems/disk1:ro
    restart: unless-stopped
    network_mode: host

volumes:
  beszel_agent:

Values set to changeme are required — replace them with your own values before starting Beszel Agent.

Prefer a managed setup? WinterFlow installs, configures, and updates Beszel Agent for you using this same Docker Compose configuration.