Skip to content

Beszel Agent on Cloudron

Background

Beszel is a lightweight server monitoring platform that includes Docker statistics, historical data, and alert functions. Bezel is available on the Cloudron App Store.

Beszel agent can be installed on Cloudron to monitor the various containers (addons and apps).

Risk warning

Please be aware of the following risks when installing the Beszel agent:

  • Cloudron does not support installing additional software on the base system.
  • The agent will have access to all the containers and data. A compromised agent (or the app) will compromise your entire system.

Configure Beszel

After installing Beszel from the App Store:

  • Add System
  • Use the public IP or dashboard domain name my.example.com of Cloudron
  • Make a note of the public key. This ireferenced as BESZEL_PUBLIC_KEY in the script below.

Installation

SSH into the server.

Install the agent. The command creates a user for beszel and add it to the docker group as well. /etc/systemd/system/beszel-agent.service is the systemd service file.

curl -sL https://get.beszel.dev -o /tmp/install-agent.sh
chmod +x /tmp/install-agent.sh
/tmp/install-agent.sh -p 45876 -k "$BESZEL_PUBLIC_KEY"

Open Firewall

You must open port 45876 in the Cloudron Firewall and any other firewall in front of the server.

On the server, edit /home/yellowtent/platformdata/firewall/ports.json:

{
    "allowed_tcp_ports": [ 45876 ],
    "allowed_udp_ports": [ ]
}

Restart the firewall to apply the configuration:

systemctl restart cloudron-firewall

Uninstalling

/tmp/install-agent.sh -u will uninstall the agent