Install Beszel Monitoring Tool on AlmaLinux 10

---

Beszel is a lightweight server monitoring platform that supports Docker statistics, historical data, alerts, and includes a friendly web interface, OAuth login, multi-user support, API access, and automatic backups.

Prerequisites

---

• AlmaLinux 10 installed
• Root privileges
• Internet access

Update the System

---

Update all packages:

dnf update -y
dnf upgrade -y

Remove conflicting Docker packages:

for pkg in docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine podman-docker containerd runc; do dnf remove -y $pkg; done

Install Required Tools

---

dnf install -y yum-utils device-mapper-persistent-data lvm2 curl

Add Docker Repository

---

dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

Install Docker Engine

dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Enable and start Docker:

systemctl enable --now docker

Test Docker:

docker run hello-world

Set Up Beszel

---

Create Directory

mkdir beszel && cd beszel

Create docker-compose.yml

---

nano docker-compose.yml

Paste the following:

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    extra_hosts:
      - host.docker.internal:host-gateway
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data

  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      PORT: 45876
      KEY: 'UPDATE WITH YOUR PUBLIC KEY (copy from "Add system" dialog)'

Start Beszel

docker compose up -d

Check if containers are running:

docker ps

)utput:

CONTAINER ID   IMAGE                         COMMAND                  CREATED          STATUS                        PORTS                                         NAMES
2d15bdc73ad1   henrygd/beszel:latest         "/beszel serve --htt…"   10 seconds ago   Up 10 seconds                 0.0.0.0:8090->8090/tcp, [::]:8090->8090/tcp   beszel
cfac1793b10a   henrygd/beszel-agent:latest   "/agent"                 10 seconds ago   Restarting (1) 1 second ago                                                 beszel-agent

Access Beszel

---

Visit the following in your browser:

http://Your_Server_IP:8090

Replace Your_Server_IP with your server's IP address.

Create Admin Account

---

On first access, you’ll be prompted to set up an admin account using email and password.

Access Dashboard

---

After setup, you will see the Beszel dashboard with stats for:

• Memory
• CPU
• Disk Usage
• Disk I/O
• Bandwidth

Add New System

Click Add System in the dashboard.

Provide:

• Name of the system
• Host or IP address
• Port number (default: 45876)
• Public key (copy from the add dialog)

Once added, the system appears in the dashboard with graphs and live monitoring.

Install Agent on Additional Systems

---

To install agent on other machines:

curl -sL https://raw.githubusercontent.com/henrygd/beszel/main/supplemental/scripts/install-agent.sh -o install-agent.sh && chmod +x install-agent.sh && ./install-agent.sh

Provide port and public key when prompted.

Manual Agent Installation (Optional)

Download Beszel Agent

---

curl -sL "https://github.com/henrygd/beszel/releases/latest/download/beszel-agent_$(uname -s)_$(uname -m | sed 's/x86_64/amd64/' | sed 's/armv7l/arm/' | sed 's/aarch64/arm64/').tar.gz" | tar -xz -O beszel-agent | tee ./beszel-agent >/dev/null && chmod +x beszel-agent

Run Agent

PORT=45876 KEY="<public key>" ./beszel-agent

Update Agent

./beszel-agent update

Done

---

Beszel is now running on AlmaLinux 10 and ready to monitor your systems with a clean, simple web interface.