# Beszel

Server monitoring hub with history, Docker stats and alerts.

- Replaces: [Datadog](https://openlogs.fyi/alternatives/datadog)
- Summary: Paid server monitoring services, such as Datadog.
- Stack: Go (language)
- Deployment: docker_compose
- License: MIT (osi) [source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/LICENSE)
- Business model: unknown. The README at the pinned commit does not state a business model, so it stays unknown. ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/readme.md), read 2026-10-22)
- Difficulty: easy. 1 service, 1 volume mount, no env values to set, no elevated host access. Heuristic score 0 of 11: easy.
- Requirements: not stated
- Repository: [henrygd/beszel](https://github.com/henrygd/beszel)

## Install

1. Docker with the Compose plugin ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml))

   ```text
   A host with Docker and the Docker Compose plugin. This entry runs from a compose file.
   ```

2. Save the compose file as docker-compose.yml ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml))

   ```yaml
   # Docs: https://beszel.dev/guide/hub-installation
   # Env vars: https://beszel.dev/guide/environment-variables
   
   services:
     beszel:
       image: "henrygd/beszel"
       container_name: "beszel"
       restart: unless-stopped
       ports:
         - "8090:8090"
       volumes:
         - ./beszel_data:/beszel_data
       # healthcheck:
       #   test: ['CMD', '/beszel', 'health', '--url', 'http://localhost:8090']
       #   interval: 120s
       #   start_period: 10s
       #   timeout: 5s
   ```

3. Start it ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml))

   ```bash
   docker compose up -d
   ```

4. Open the app ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml))

   ```text
   Open http://localhost:8090. The compose file publishes host port 8090 for the beszel service.
   ```

Compose file check: config_ok on 2026-10-22.

## Gotchas and maintenance

### Gotchas

- Some images use the latest tag or no tag: Images without a pinned version: beszel: henrygd/beszel (no tag). A later pull can get a different version. ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml), checked 2026-10-22)
- The compose file publishes host ports: Host ports: 8090 (beszel). A port without a host address listens on all host network interfaces. ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml), checked 2026-10-22)
- The compose file mounts host folders: Host paths mounted into containers: ./beszel_data at /beszel_data (beszel). ([source](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml), checked 2026-10-22)

### Signals

Computed from a GitHub snapshot taken 2026-10-22.

- Open issues and pull requests: 337
- Stars: 26426, forks: 1105
- Last push: 2026-10-21 (0 days ago)
- Latest release: v0.21.0 on 2026-10-02 (19 days ago)

## Sources

- [Repository: https://github.com/henrygd/beszel](https://github.com/henrygd/beszel)
- [License: https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/LICENSE](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/LICENSE)
- [Business model: https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/readme.md](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/readme.md)
- [Compose file: https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml](https://github.com/henrygd/beszel/blob/b97abf7662a7c7a2dd7542ea2062405abd22d4dc/supplemental/docker/hub/docker-compose.yml)

---
Canonical: https://openlogs.fyi/tools/beszel  
Last updated: 2026-10-22
