How to install Beszel on a Cloud VPS

Beszel is a lightweight server monitoring hub with historical charts for CPU, memory, disk, network and Docker containers, plus configurable alerts.

Monitoring on your own server gives you alerts and history without host limits or per-monitor monthly fees.

One-click install on cloudlinux.ro

The fastest way: Beszel installs automatically at the first boot of a new server.

1. Create a Cloud VPS from the control panel.
2. In the configuration step, pick Beszel from the app catalog.
3. Start the server. The install runs in the background for a few minutes and its status shows on the server page.
4. Access details and generated passwords are saved on the server in /root/app-credentials.txt. The app will be available on port 8090.

Manual install on any Ubuntu server

If you prefer doing it yourself, below is the exact script our automatic install runs. Execute it as root on a fresh Ubuntu server (24.04 recommended). It stops at the first error, and when it finishes you will find the access details in /root/app-credentials.txt.

export DEBIAN_FRONTEND=noninteractive
curl -fsSL https://get.docker.com | sh
IP=$(hostname -I | awk '{print $1}')
mkdir -p /opt/beszel && cd /opt/beszel
cat > docker-compose.yml <<EOF
services:
  beszel:
    image: henrygd/beszel:latest
    restart: unless-stopped
    ports:
      - '8090:8090'
    volumes:
      - ./beszel_data:/beszel_data
      - ./beszel_socket:/beszel_socket
  beszel-agent:
    image: henrygd/beszel-agent:latest
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./beszel_agent_data:/var/lib/beszel-agent
      - ./beszel_socket:/beszel_socket
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      LISTEN: /beszel_socket/beszel.sock
      HUB_URL: http://localhost:8090
EOF
docker compose up -d
printf 'Beszel: http://%s:8090\nCreeaza contul de administrator la prima accesare.\nPentru a monitoriza acest server: Add System -> alege socket (/beszel_socket/beszel.sock), copiaza KEY si TOKEN in sectiunea environment a agentului din /opt/beszel/docker-compose.yml, apoi ruleaza: cd /opt/beszel && docker compose up -d\n' "$IP" > /root/app-credentials.txt

You can also save this script as a recipe in your account and reuse it on any new server.