Docker & Arcane Setup Guide (Ubuntu Server)
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:
# 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:
sudo usermod -aG docker $USER
newgrp docker
Verificér at Docker og Compose kører:
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/:
/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
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:
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:
openssl rand -hex 32
Trin 2: Opret docker-compose.yml for Arcane
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):
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:
/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
docker compose up -d
Åbn derefter http://192.0.2.15:3552 i din browser og opret din administrator-bruger.
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/docker5. 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/:
cd /opt/docker/monitoring
vi docker-compose.yml
Eksempel med Uptime Kuma og Grafana (som benytter Named Volumes til deres data):
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):
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:
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:
services:
grafana:
image: grafana/grafana-oss:latest
container_name: grafana
networks:
- proxy-net
networks:
proxy-net:
external: true