Beszel API on HomeAssistant
June 20, 2025
TutorialHomeAssistant
Hello everyone,
I built a HomeAssistant integration for Beszel (not another agent, but for monitoring) that you can use too.
Here is the GitHub-Link to my repository: Ronjar/beszel-ha.
If you miss any functionality or encounter errors, please open an issue or, for smaller features, just open a pull request.
Currently it supports:
- Status (Connected or Disconnected)
- Uptime (Minutes)
- CPU (Percentage)
- RAM (Percentage)
- DISK usage (Percentage)
- Temperature (°C)
- Bandwidth (MBit/s)
I will implement more sensors once I find the time to do it.
Usage
This is just an integration, aka no additional UI elements. But just with some bar- and mushroom cards you can build some good looking layouts. Here is a example:
type: custom:vertical-stack-in-card
cards:
- type: horizontal-stack
cards:
- type: custom:mushroom-template-card
primary: Evergreen
icon: mdi:server
secondary: ""
icon_color: |-
{% if states('binary_sensor.evergreen_status') | bool %}
green
{% else %}
red
{% endif %}
fill_container: false
multiline_secondary: false
entity: binary_sensor.evergreen_status
- type: custom:mushroom-template-card
entity: sensor.evergreen_uptime
icon: mdi:sort-clock-descending
primary: "{{ (states('sensor.evergreen_uptime') | int / 1440) | int }} Days"
secondary: ""
icon_color: blue
card_mod:
style: |
ha-card {
margin: 0 10px;
align-items: end;
box-shadow: none;
}
- type: custom:bar-card
entities:
- entity: sensor.evergreen_cpu
name: CPU
color: "#4caf50"
- entity: sensor.evergreen_ram
name: RAM
color: "#2196f3"
- entity: sensor.evergreen_disk
name: Disk
color: "#f44336"
positions:
indicator: "off"