Podrobný návod na instalaci Beszel na Raspberry Pi

1. Příprava adresářů a souborů

Nejprve se připoj na své Raspberry Pi přes SSH a vytvoř potřebné adresáře:

# Vytvoření hlavního adresáře pro Beszel
sudo mkdir -p /opt/beszel

# Vytvoření podadresářů
sudo mkdir -p /opt/beszel/data
sudo mkdir -p /opt/beszel/agent

# Nastavení oprávnění
sudo chown -R $USER:$USER /opt/beszel
sudo chmod -R 755 /opt/beszel

2. Instalace přes Portainer Stack

Otevři Portainer ve webovém prohlížeči (obvykle http://IP_ADRESA:9000)
Přejdi na Stacks v levém menu
Klikni na "Add stack"
Zadej název stacku: beszel-monitoring
Zkopíruj YAML kód z artefaktu výše do editoru
Klikni na "Deploy the stack"

version: '3.8'

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    ports:
      - "8090:8090"
    volumes:
      - /opt/beszel/data:/beszel_data
    environment:
      - TZ=Europe/Prague
    networks:
      - beszel_network

  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
      - /:/host:ro
      - /opt/beszel/agent:/app/data
    environment:
      - BESZEL_AGENT_HOST=0.0.0.0
      - BESZEL_AGENT_PORT=45876
      - TZ=Europe/Prague
      - KEY_FILE=/app/data/key
    privileged: true

networks:
  beszel_network:
    driver: bridge

3. Konfigurace po instalaci

Po úspěšném nasazení:

Otevři webové rozhraní Beszel: http://IP_RASPBERRY_PI:8090
Při prvním spuštění si vytvoř admin účet
Přidej své Raspberry Pi jako agent:
- Hostname/IP: IP adresa tvého Raspberry Pi
- Port: 45876
- SSL: vypni (pokud nepoužíváš HTTPS)

4. Důležité poznámky pro Raspberry Pi

Architektura: Docker image podporuje ARM64 architekturu pro RPi 4/5
Výkon: Beszel je optimalizován pro nízkou spotřebu, ideální pro RPi
Port 45876: Ujisti se, že je port otevřený v firewallu
Privileged mode: Agent potřebuje privilegované oprávnění pro monitoring systému

5. Monitorované metriky

Beszel bude sledovat:

CPU využití a teplotu
RAM a swap využití
Diskové úložiště
Síťový provoz
Docker kontejnery
Systémové procesy

6. Údržba

# Kontrola logů
docker logs beszel
docker logs beszel-agent

# Restart služeb
docker restart beszel beszel-agent

# Aktualizace
docker-compose pull && docker-compose up -d

Beszel je výborná volba pro monitoring Raspberry Pi, protože má minimální nároky na systém a poskytuje přehledné webové rozhraní!

Návod na instalaci Beszel Agenta (verze s Tokenem)

1. Získání Tokenu (Na hlavním Beszel Hubu)

Otevři webové rozhraní Beszel Hubu.
Klikni na tlačítko Add System.
Do pole Name napiš název nového RPi (např. Nove-RPi).
Do pole Host napiš IP adresu tohoto nového RPi.
Klikni na Add (nebo Save).
V seznamu systémů uvidíš u nově přidaného záznamu sloupec Token. Tento kód si zkopíruj.

2. Příprava adresáře (Na novém RPi přes SSH)

I když nepoužíváme soubor s klíčem, agent potřebuje datovou složku pro svou vnitřní databázi.

sudo mkdir -p /opt/beszel-agent/data
sudo chown -R $USER:$USER /opt/beszel-agent

3. Nasazení v Portaineru (Na novém RPi)

Otevři Portainer na novém zařízení.
Jdi do Stacks -> Add stack.
Název: beszel-agent.
Vlož následující YAML kód:

version: '3.8'

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    privileged: true
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - /:/host:ro
      - /opt/beszel-agent/data:/app/data
    environment:
      - PORT=45876
      - KEY=ZDE_VLOZ_TOKEN_Z_KROKU_1

V řádku - KEY= nahraď text ZDE_VLOZ_TOKEN_Z_KROKU_1 tím tokenem, který jsi zkopíroval v prvním kroku.
Klikni na Deploy the stack.

Ověření funkčnosti

V Portaineru zkontroluj, že kontejner beszel-agent běží (Status: running).
Na hlavním Beszel Hubu se u nového systému změní stav na Online (zelená kontrolka) a začnou se načítat data.

Funkční pro LINUX server Ubuntu:

Ve stack yml kod portaineru:

version: "3.9"

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    
    environment:
      # URL tvého Beszel hubu – upraveno DLE TVÝCH DAT
      - HUB_URL=http://192.168.54.4:8090
      # Váš SSH Klíč
      - KEY=ssh-ed25519 AAAAC3zadfgfdGTFGHJ1lZDI1NTE5AAAIFtwhzb4bOxyIlB+ko1suJgRsuQlJO+6W9Jnp
      # Váš Token
      - TOKEN=3fde-731f5e2ddfdsfsdf-2aea-113c6a
      # Volitelné: vlastní název stroje
      - NAME=Ubuntu-Server
      # Port agenta (nechte)
      - PORT=45876
      # *** KLÍČOVÉ PŘIDÁNÍ: POUŽÍT DOCKER SOCKET ***
      - DOCKER_HOST=unix:///var/run/docker.sock 
      
    volumes:
      # *** KLÍČOVÉ PŘIDÁNÍ: NAMONTOVÁNÍ DOCKER SOCKETU ***
      - /var/run/docker.sock:/var/run/docker.sock
      # Můžete přidat i volume pro data agenta, pokud je požadováno:
      # - agent_data:/var/lib/beszel-agent
      
    ports:
      # Port SSH serveru BESZEL (pokud ho používáte)
      - "45876:45876"
      
    networks:
      - beszel-net

networks:
  beszel-net:
    driver: bridge