Quick Start

🇩🇪 Deutsch

From zero to a running ITSWEBER Mesh in under 5 minutes.

Prerequisites

• Docker (Linux, macOS or Windows with WSL2)
• A free port — default is 3000
• ~150 MB free disk space for the image

On Unraid? Jump straight to Unraid Installation — we cover the Community Apps variant there.

Step 1 — Create a directory

Mesh persists its entire configuration in a single volume. Create an empty directory:

mkdir -p ~/itsweber-mesh-data

Step 2 — Generate a session secret

Mesh signs session cookies with an HMAC secret. Generate one at least 32 characters long once and save it — it is reused on every container replacement.

openssl rand -hex 32

⚠ If you change the secret on a restart, all active sessions are invalidated and all users must log in again.

Step 3 — Start the container

docker run -d \
  --name itsweber-mesh \
  --restart=unless-stopped \
  -p 3000:3000 \
  -e MESH_SESSION_SECRET="<your-secret-here>" \
  -e TZ="Europe/Berlin" \
  -v ~/itsweber-mesh-data:/data \
  ghcr.io/itsweber/mesh:latest

Step 4 — Open in browser

→ http://localhost:3000

On the first visit the First Run Wizard runs: it asks for the dashboard name, language and theme, and creates your admin user.

What's next?

1. Add services — Admin → Content → Services
2. Pin frequently used ones to the dashboard — toggle in each service editor
3. Connect integrations — Admin → Integrations (Home Assistant, Glances, AdGuard … see Integrations Overview)
4. Customise the theme — Admin → System → Theme

With docker-compose

services:
  mesh:
    image: ghcr.io/itsweber/mesh:latest
    container_name: itsweber-mesh
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      MESH_SESSION_SECRET: ${MESH_SESSION_SECRET}
      TZ: Europe/Berlin
    volumes:
      - ./mesh-data:/data

In .env:

MESH_SESSION_SECRET=1e3741a206ef84dde3cad5c7e6aa31b4d151e87c605d5ffdbf1b273ea81f99d1

Start: docker compose up -d.