IPv4 Klient Forbinder...
IP Adresse: Søger... (home)
Reverse DNS: -
Provider / ASN: -
IPv6 Klient Forbinder...
IP Adresse: Søger... (home)
Reverse DNS: -
Provider / ASN: -
Forbindelse & Sikkerhed HTTPS
SSL / TLS: Søger...
Protokol: HTTP/1.1
⬅ Tilbage til Noter
/

Docker & Arcane Setup Guide (Ubuntu Server)

📅 Udgivet: 2026-11-07
#docker #arcane #compose #ubuntu #homelab #linux

Docker & Arcane Setup Guide (Ubuntu Server)

Denne guide gennemgår, hvordan du sætter en helt frisk Ubuntu-server (f.eks. docker-worker-1) op fra bunden med Docker Engine, en ren og skalerbar mappestruktur under /opt/docker/, samt Arcane ↗ til grafisk styring af dine stacks, containere og opdateringer.


1. Installér Docker på Ubuntu

Log ind på din nye Ubuntu-server via SSH og installér den officielle Docker Engine inkl. Docker Compose plugin:

BASH
# Opdater pakkelister og hent officielle Docker installations-script
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | sudo sh

Tilføj din egen Linux-bruger til docker-gruppen, så du kan køre docker-kommandoer uden sudo:

BASH
sudo usermod -aG docker $USER
newgrp docker

Verificér at Docker og Compose kører:

BASH
docker --version
docker compose version

2. Mappestruktur: Én mappe pr. Stack i /opt/docker/

I stedet for at samle alle containere i én kæmpestor docker-compose.yml, opdeles tjenesterne i logiske små stacks (projekter) under /opt/docker/:

TEXT
/opt/docker/
├── arcane/                 # Selve Arcane kontrolpanelet (isoleret for sig selv)
│   └── docker-compose.yml
├── infra/                  # Infrastruktur (f.eks. Netbird, Reverse Proxy, DNS)
│   └── docker-compose.yml
├── monitoring/             # Overvågning (f.eks. Uptime Kuma, Grafana)
│   └── docker-compose.yml
└── librenms/               # Større fler-container systemer i egen mappe
    └── docker-compose.yml
💡 Tip: Hvorfor skal Arcane ligge i sin egen mappe? Hvis Arcane ligger i samme docker-compose.yml som dine andre infrastruktur-containere, vil Arcane slukke sig selv midt i kommandoen, når du trykker Restart eller Redeploy på stakken inde fra Web UI. Ved at isolere /opt/docker/arcane/ kan du frit genstarte alle andre stacks fra brugerfladen.

Opret rodmappen og giv din bruger ejerskab:

BASH
sudo mkdir -p /opt/docker/arcane /opt/docker/infra /opt/docker/monitoring
sudo chown -R $USER:$USER /opt/docker

3. Data-strategi: Named Volumes vs. Bind Mounts

Når en container skal gemme data permanent, har du to muligheder i din docker-compose.yml. Som ny i Docker er Hybrid-modellen langt den nemmeste og mest driftsikre:

Tommelfingerreglen:

  • Brug Named Volumes (90% af tiden — databaser og app-data):

Når du skriver uptime-data:/app/data, gemmer Docker automatisk data i /var/lib/docker/volumes/uptime-data/_data.

  • Fordel: Docker sætter selv de rigtige filrettigheder (du undgår Permission denied-fejl ved opstart af f.eks. Grafana eller databaser), og alle dine volumes vises pænt med størrelse og status under Volumes-fanen i Arcane.
  • Brug Bind Mounts (10% af tiden — kun til config-filer du selv redigerer i CLI):

Når en container kræver en konfigurationsfil, du selv skal redigere med vi fra terminalen (f.eks. ./prometheus.yml:/etc/prometheus/prometheus.yml), lægger du filen direkte i stack-mappen ved siden af docker-compose.yml.


4. Opsætning af Arcane (/opt/docker/arcane/)

Arcane fungerer "filesystem-first": Den læser og skriver direkte til dine docker-compose.yml-filer i /opt/docker/. Du kan derfor skifte frit mellem at redigere filer med vi over SSH og i Arcanes Web UI.

Trin 1: Generér krypteringsnøgle

Kør følgende kommando og kopiér den 64-tegns hex-streng, der skrives ud:

BASH
openssl rand -hex 32

Trin 2: Opret docker-compose.yml for Arcane

BASH
cd /opt/docker/arcane
vi docker-compose.yml

Indsæt følgende konfiguration (erstat 192.0.2.15 med serverens IP og indsæt din genererede nøgle):

YAML
services:
  arcane:
    image: ghcr.io/getarcaneapp/manager:latest
    container_name: arcane
    ports:
      - "3552:3552"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - arcane-data:/app/data
      - /opt/docker:/opt/docker
    environment:
      - TZ=Europe/Copenhagen
      - APP_URL=http://192.0.2.15:3552
      - PUID=1000
      - PGID=1000
      - ENCRYPTION_KEY=indsæt_din_openssl_rand_hex_32_nøgle_her
      - PROJECTS_DIRECTORY=/opt/docker
    cgroup: host
    restart: unless-stopped

volumes:
  arcane-data:
ℹ️ Note: Path Parity-reglen: Bemærk at /opt/docker på hosten er mountet til præcis /opt/docker inde i containeren (- /opt/docker:/opt/docker) kombineret med PROJECTS_DIRECTORY=/opt/docker. Det sikrer, at alle stier stemmer 1:1 overens, når Arcane starter dine stacks.

Trin 3: Start Arcane

BASH
docker compose up -d

Åbn derefter http://192.0.2.15:3552 i din browser og opret din administrator-bruger.

⚠️ Warning: Fejl ved gem i Arcane UI (mkdirat .project-update-backup-...: permission denied): Når du redigerer en stack i Arcane UI, opretter Arcane en midlertidig backup-mappe i /opt/docker/. Hvis /opt/docker (eller en undermappe) er blevet oprettet med sudo og ejes af root, afvises Arcane. Løs det ved at sætte ejerskabet til samme bruger-ID som PUID/PGID (typisk 1000:1000): sudo chown -R 1000:1000 /opt/docker

5. Eksempel: Opret din første Stack (monitoring)

Du kan nu oprette nye stacks enten direkte i Arcanes Web UI under Projects → New Project eller via CLI i /opt/docker/monitoring/:

BASH
cd /opt/docker/monitoring
vi docker-compose.yml

Eksempel med Uptime Kuma og Grafana (som benytter Named Volumes til deres data):

YAML
services:
  uptime-kuma:
    image: louislam/uptime-kuma:1
    container_name: uptime-kuma
    ports:
      - "3001:3001"
    volumes:
      - uptime-data:/app/data
    environment:
      - TZ=Europe/Copenhagen
    restart: unless-stopped

  grafana:
    image: grafana/grafana-oss:latest
    container_name: grafana
    ports:
      - "3000:3000"
    volumes:
      - grafana-data:/var/lib/grafana
    environment:
      - TZ=Europe/Copenhagen
    restart: unless-stopped

volumes:
  uptime-data:
  grafana-data:

Start stakken fra CLI (eller klik Deploy inde i Arcane under Projects → monitoring):

BASH
docker compose up -d

6. Kommunikation på tværs af Stacks (Fælles Docker Netværk)

Når dine containere er opdelt i hver sin mappe, opretter Docker som standard et isoleret netværk pr. mappe. Hvis en Reverse Proxy (f.eks. Nginx Proxy Manager i /opt/docker/infra/) skal kunne sende trafik videre til Grafana i /opt/docker/monitoring/, opretter du ét fælles eksternt netværk:

BASH
docker network create proxy-net

Herefter kan du koble enhver container på tværs af dine mapper på proxy-net ved blot at tilføje netværket i deres docker-compose.yml:

YAML
services:
  grafana:
    image: grafana/grafana-oss:latest
    container_name: grafana
    networks:
      - proxy-net

networks:
  proxy-net:
    external: true
Kopieret: