Install Hub

Beszel supports installation via Docker or using binaries.

• Docker
• Binary
  • Quick script
  • Manual download and startup
  • Build and Startup

Docker

Both methods will start the Beszel service on port 8090 and mount the ./beszel_data directory for persistent storage.

docker-compose.yml

# Run with docker compose up -d
services:
  beszel:
    image: 'henrygd/beszel'
    container_name: 'beszel'
    restart: unless-stopped
    ports:
      - '8090:8090'
    volumes:
      - ./beszel_data:/beszel_data

docker run

mkdir -p ./beszel_data && \
docker run -d \
  -v ./beszel_data:/beszel_data \
  -p 8090:8090 \
  henrygd/beszel

Binary

There are multiple ways to install using binary files. You can choose one of the methods below that you prefer.

1. Quick script

• -u : Uninstall the Beszel Hub
• -p <port> : Specify a port number (default: 8090)

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

2. Manual Download and Startup

Click to expand/collapse

Download the latest binary from releases that matches your server's CPU architecture and run it manually. However, you will need to create a service manually to keep it running.

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

Running the hub directly:

./beszel serve

3. Build and Startup

Click to expand/collapse

Beszel are written in Go, so you can easily build them yourself, or cross-compile for different platforms. Please install Go first if you haven't already.

1. Git clone & Prepare dependencies

git clone https://github.com/henrygd/beszel.git
cd beszel && go mod tidy

2. Build

The hub embeds the web UI in the binary, so you must build the website first. This project uses bun by default, but you may use Node.js if you prefer:

cd beszel/site
bun install
bun run build

Then in beszel/cmd/hub:

cd beszel/cmd/hub
CGO_ENABLED=0 go build -ldflags "-w -s" .

TIP

If you need to run on different platforms, you can cross-compile using the GOOS and GOARCH environment variables.

For example, to build for FreeBSD ARM64:

GOOS=freebsd GOARCH=arm64 CGO_ENABLED=0 go build -ldflags "-w -s" .

You can see a list of valid options by running go tool dist list.

4. Running the hub directly

You will need to create a service manually to keep it running.

./beszel serve