QNAP-NAS: Installation von Arcane zur Verwaltung von Docker-Containern

Einleitung

Zur Verwaltung meiner Docker-Umgebung habe ich nach einer Lösung gesucht, die etwas mehr Funktionalität bietet als die QNAP-Container-Station. Vor allem war mir wichtig, Container schnell und einfach updaten zu können.

Dabei bin ich neben dem bekannten Portainer auch auf Arcane gestoßen. Letztere hat zwar einen etwas kleineren Funktionsumfang, ist aber für das einfache Verwalten von Docker-Containern völlig ausreichend. Zudem ist die Benutzeroberfläche deutlich moderner und ansprechender.

Laufen soll das Ganze auf meinem QNAP TS-873A unter QuTS hero als Docker-Container über die QNAP-Container-Station.

Wichtig: Die Nutzung dieser Anleitung erfolgt auf eigenes Risiko.

Vorbereitung

Container-Station

Zunächst wird die Container-Station benötigt. Ist diese bisher nicht installiert, kann dies einfach über das App-Center innerhalb der Administrationsoberfläche des NAS erfolgen.

Temporärer Container zur Erstellung der Verschlüsselungskeys

Zunächst muss in der Container-Station ein neuer (temporären) Container erstellt werden, um die für die Installation erforderlichen Verschlüsselungskeys generieren zu können.

Beim Modus wählt ihr Advanced aus und fügt bei der Image-Adresse ghcr.io/getarcaneapp/arcane:latest ein.

Auf der folgenden Seite benennen wir den Container arcane-temp und wählen auch hier die erweiterten Einstellungen. Unter Commands muss der Standardbefehl mit /app/arcane generate secret überschrieben werden.

Nach dem Fertigstellen werden im Log des Containers in regelmäßigen Abständen neue Schlüssel mit dem jeweils zugehörigen Geheimnis angezeigt.

Diese Informationen müssen kopiert und in die Compose-Datei eingefügt werden. Der Container „arcane-temp“ wird nun nicht mehr benötigt und kann wieder gelöscht werden.

Installation

Für die Installation via Docker wird ein Installationsskript, auch bekannt als Docker-Compose-Datei, benötigt.

Öffnet die Container-Station in der Weboberfläche des NAS, klickt auf Anwendungen (Applications) und dann auf Erstellen (create). Gebt nun als Containernamen arcane ein und fügt die Docker-Compose-Datei von der offiziellen Homepage ein und ersetzt dabei die rot markierten Inhalte durch den Key und das zugehörige Secret aus dem vorigen Schritt:

services:
arcane:
image: ghcr.io/getarcaneapp/arcane:latest
container_name: arcane
ports:
- "3552:3552"
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- arcane-data:/app/data
- /host/path/to/projects:/app/data/projects
environment:
- APP_URL=http://localhost:3552
- PUID=1000
- PGID=1000
- ENCRYPTION_KEY=xxxxxxxxxxxxxxxxxxxxxx
- JWT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxx
restart: unless-stopped

volumes:
arcane-data:

Zugriff auf Arcane

Wenn der Arcane-Container erfolgreich gestartet wurde, könnt ihr Arcane über die IP des NAS und unter Angabe des Ports 3552 öffnen, sofern ihr den Port in der Compose-Datei nicht geändert habt. Also beispielsweise: 192.168.0.200:3552

Die Anmeldeinformationen für die erste Anmeldung lauten standardmäßig:

  • Benutzername: arcane
  • Passwort: arcane-admin

Nach der ersten Anmeldung müsst ihr zunächst das Passwort ändern. Danach erscheint die Oberfläche von Arcane und es sollten alle eure Docker-Container angezeigt werden.