diff --git a/README.md b/README.md index 4e6db9d..bf90bb1 100644 --- a/README.md +++ b/README.md @@ -199,6 +199,7 @@ Tools and software for [software project management](https://en.wikipedia.org/wi - [Watchtower](examples/watchtower) - A container-based solution for automating Docker container base image updates. - [Unify Network Application](examples/unify-network-application) - The Unifi-network-application software is a powerful, enterprise wireless software engine ideal for high-density client deployments requiring low latency and high uptime performance. - [UpSnap](examples/upsnap) - A simple wake on lan app written with SvelteKit, Go, PocketBase and nmap. +- [Beszel](examples/beszel) - Lightweight server monitoring platform with Docker statistics, historical data, and alerts. ### Recipe Management diff --git a/examples/beszel/README.md b/examples/beszel/README.md new file mode 100644 index 0000000..9b3ea48 --- /dev/null +++ b/examples/beszel/README.md @@ -0,0 +1,15 @@ +# References + +- https://beszel.dev/ +- https://github.com/henrygd/beszel + +# Notes + +Beszel is a lightweight server monitoring platform that includes Docker statistics, historical data, and alert functions. + +The hub (this compose file) provides the web UI and communicates with agents installed on each monitored system. The agent can either be installed as a standalone binary or as a separate Docker container (see the Beszel docs for agent setup options). + +After starting the hub, create your admin account by visiting `http://localhost:8090` and navigating through the initial setup. Then add your systems via the dashboard and deploy the agent on each host you want to monitor. + +> [!NOTE] +> Make sure the agent port (default `45876`) is reachable from the Beszel hub. For agent-only deployments on the same host, see the `extra_hosts` approach documented upstream. diff --git a/examples/beszel/docker-compose.yml b/examples/beszel/docker-compose.yml new file mode 100644 index 0000000..b0daadf --- /dev/null +++ b/examples/beszel/docker-compose.yml @@ -0,0 +1,26 @@ +services: + + beszel: + image: henrygd/beszel:latest + container_name: beszel + hostname: beszel + restart: unless-stopped + ports: + - 8090:8090/tcp + expose: + - 8090 + volumes: + - ${DOCKER_VOLUME_STORAGE:-/mnt/docker-volumes}/beszel:/beszel_data + #networks: + # - proxy + #labels: + # - traefik.enable=true + # - traefik.docker.network=proxy + # - traefik.http.routers.beszel.rule=Host(`beszel.example.com`) + # - traefik.http.services.beszel.loadbalancer.server.port=8090 + # # Optional part for traefik middlewares + # - traefik.http.routers.beszel.middlewares=local-ipwhitelist@file + +#networks: +# proxy: +# external: true