Hoard mit Docker selbst hosten (Self-Hosting)

Hoard ist Open Source und selbst hostbar. Statt Hoard Cloud zu nutzen, kannst du denselben hoard-server auf deiner eigenen Maschine betreiben und jedes Gerät darauf verweisen – ohne Konto und ohne Speicherlimit außer der Festplatte, die du ihm gibst. Diese Anleitung bringt einen Server in wenigen Minuten mit Docker zum Laufen.

Warum Hoard selbst hosten

• Volle Kontrolle. Deine Spielstände liegen auf Hardware, die du kontrollierst, nicht in fremder Cloud.
• Kein Limit. Der Speicher wird nur von deiner eigenen Festplatte begrenzt.
• Gleiche App, gleiche Funktionen. Versionierter Verlauf und Hintergrund-Sync funktionieren genau wie mit Hoard Cloud – nur das Backend ändert sich.
• Open Source. Du kannst den Server lesen, prüfen und anpassen.

Das ist der entscheidende Unterschied zu Tools wie Ludusavi: Ludusavi ist großartig für lokale Backups und eigene Cloud per Rclone, aber den Sync richtest du selbst ein. Hoard bietet dir einen verwalteten Sync-Server, den du einmal startest und mit dem sich jedes Gerät verbindet.

Was Selbsthosten für deine Daten bedeutet

Das gehört klar gesagt, denn genau hier liegen die meisten Vergleiche bei Hoard falsch.

Hoard Cloud ist die verwaltete Variante: du meldest dich an, und deine Spielstände liegen auf unseren Servern in der EU.

Ein selbst gehostetes Hoard gehört vollständig dir. Deine Geräte sprechen mit deinem Server und mit sonst nichts. Es gibt kein Konto bei uns, keine Telemetrie zu uns, kein Limit und kein Relay — nichts läuft über unsere Server, weil nichts von uns im Weg steht. Wir können weder einen Spielstand noch einen Spieltitel noch eine E-Mail-Adresse sehen, schlicht weil davon nichts bei uns ankommt. Würde Hoard Cloud morgen abgeschaltet, liefe dein Setup unverändert weiter.

Eine Sache der Genauigkeit halber: dein Server hat sehr wohl eigene Zugänge — den Benutzer, den du unten anlegst, und ein Token je Gerät. Die gehören dir, auf deiner Maschine, in deiner Datenbank. Was es nicht gibt, ist ein Konto bei uns.

Was du brauchst

• Eine Maschine, die durchläuft (Heimserver, NAS mit Docker oder ein kleiner VPS).
• Docker und Docker Compose installiert (auf einem Synology-NAS das Paket Container Manager).
• Optional eine Domain und ein Reverse-Proxy für HTTPS (empfohlen für alles außerhalb deines LAN).

Installation mit Docker Compose

Du musst das Repository nicht klonen. Der Server ist ein fertiges Image (ghcr.io/rleeon/hoard, amd64 und arm64), und herunterladen musst du nur seine docker-compose.yml:

mkdir hoard && cd hoard
curl -O https://raw.githubusercontent.com/rleeon/hoard/main/deploy/docker/docker-compose.yml

# Used only on the first start: they create that admin and print a device token in the log, once
HOARD_ADMIN_USERNAME=alice HOARD_ADMIN_PASSWORD='CHANGE_ME' docker compose up -d
docker compose logs -f server                  # wait for "listening", then copy the token

Beim ersten Start schreibt der Container eine funktionierende config.toml nach ./config/, neben die Compose-Datei; mit einfachem docker compose gibt es also nichts vorzubereiten. Die Daten liegen in einem benannten Docker-Volume (hoard-data) – sichere es wie jedes andere Volume. Der Container lauscht intern auf Port 12421; einen anderen Host-Port setzt du mit HOARD_PORT=9000 docker compose up -d.

Willst du die Konfiguration lesen, bevor irgendetwas startet, oder das Image selbst bauen, erklärt die Self-Hosting-Anleitung im Repository, wie du es klonst.

Auf einem Synology-NAS (Container Manager)

Container Manager hat keine Kommandozeile, über die du diese beiden Variablen übergeben könntest, und startet kein Projekt, solange ein eingebundener Ordner fehlt: Das ist der Fehler Bind mount failed: '…/config' does not exist. Vier Schritte lösen beides:

1. Lege in der File Station einen Ordner für Hoard an (zum Beispiel docker/hoard) und darin einen leeren Ordner config.

2. Öffne im Container Manager Project → Create, wähle diesen Ordner als Pfad, lass eine docker-compose.yml anlegen und füge dort den Inhalt der Datei ein (öffne dazu die URL aus der curl-Zeile oben im Browser).

3. Ersetze in der eingefügten Datei ${HOARD_ADMIN_USERNAME:-} und ${HOARD_ADMIN_PASSWORD:-} durch Benutzernamen und Passwort deines Admins und lass den Rest jeder Zeile stehen, sodass die beiden Zeilen so aussehen:

   HOARD_ADMIN_USERNAME: alice
   HOARD_ADMIN_PASSWORD: 'CHANGE_ME'
   

4. Schließe den Assistenten ab, um ihn zu starten, und öffne unter Container das Protokoll von hoard-server: Dort steht das Geräte-Token, ein einziges Mal.

Mit der Datei, wie sie ist, liegen die Spielstände im eigenen Speicher von Docker, außerhalb deiner freigegebenen Ordner. Sollen sie in einem freigegebenen Ordner liegen, den du ohnehin sicherst, lege neben config auch einen Ordner data an und ändere die Zeile hoard-data:/var/lib/hoard in ./data:/var/lib/hoard.

Benutzer und Geräte-Token anlegen

Hast du ihn mit HOARD_ADMIN_USERNAME und HOARD_ADMIN_PASSWORD gestartet, ist das schon erledigt: Der Benutzer existiert und sein Token steht im Log. Andernfalls legst du beides auf der Kommandozeile an, denn der Server hat keine Registrierungsseite:

docker compose exec server hoard-admin --config /etc/hoard/config.toml \
    user create alice --admin --password 'CHANGE_ME'
docker compose exec server hoard-admin --config /etc/hoard/config.toml \
    token create alice --device 'desktop'

Das Token wird nur einmal angezeigt und kann später nicht wiederhergestellt werden, also kopiere es jetzt. Für jedes weitere Gerät brauchst du kein Terminal: Öffne die Adresse deines Servers im Browser, melde dich mit diesem Benutzernamen und Passwort im Web-Panel an und nutze Benutzer → Neues Token.

Die Desktop-App verbinden

Installiere die Hoard-Desktop-App auf jedem Rechner. Wähle im Onboarding Self-Host und füge deine Server-URL und das eben erstellte Token ein. Ab da verhält es sich genau wie Hoard Cloud: Es erkennt deine Spiele, sichert Spielstände automatisch und führt einen versionierten Verlauf. Siehe Spielstände zwischen PCs synchronisieren für den Alltag.

Halte deinen Server aktuell

Wie du aktualisierst, hängt davon ab, wie du installiert hast — und der falsche Befehl liefert keinen Fehler, sondern tut schlicht nichts. Es lohnt sich also zu wissen, welcher deiner ist.

Docker Compose. Neues Image holen und den Container neu erstellen. Beide Hälften, in dieser Reihenfolge:

docker compose pull
docker compose up -d

Hörst du nach der ersten auf, läuft der alte Container unberührt weiter: /v1/health meldet weiterhin die alte Version, und das Update sieht aus, als wäre es still gescheitert. git pull aktualisiert weder das eine noch das andere — was läuft, ist das veröffentlichte Image, nicht dein Checkout. Nagle eine Version fest (ghcr.io/rleeon/hoard:1.1) statt :latest, wenn du lieber selbst entscheidest, wann eine neue kommt.

Unraid. Reiter Docker → Hoard → Apply update, sobald eines angeboten wird. Nichts zu tippen.

Bare Metal (systemd). sudo hoard-server upgrade, danach sudo systemctl restart hoard-server. Der Befehl tauscht die Binärdatei atomar aus und startet den Dienst absichtlich nicht selbst neu, damit eine laufende Synchronisierung nicht abgeschnitten wird.

hoard-server upgrade gilt nur für die Bare-Metal-Installation. In einem Container verweigert er sich absichtlich — der Binärtausch würde das nächste docker compose up -d nicht überleben — und gibt stattdessen die beiden Befehle von oben aus; führe docker compose exec server hoard-server upgrade aus, wenn du es selbst sehen willst. Datenbankmigrationen wendet der Server beim Start an, dafür gibt es also nie einen eigenen Schritt.

Im Produktivbetrieb

Für alles, was über dein lokales Netz hinausgeht, beende TLS an einem Reverse-Proxy (Caddy, nginx oder Traefik). Lieber Bare Metal? Das Repo liefert auch ein systemd-Installationsskript und einen Befehl hoard-server upgrade, der die Binärdatei atomar austauscht, ohne einen laufenden Sync abzubrechen.

Selbst hosten oder Hoard Cloud?

Selbst-Hosting ist ideal, wenn du schon einen Server betreibst und volle Kontrolle ohne Limit willst. Wenn du keine Infrastruktur pflegen möchtest, bietet dir Hoard Cloud denselben Sync verwaltet, mit einem kostenlosen Einstieg. So oder so bleiben App und Spielstände portabel – du kannst später wechseln.

Häufige Fragen

Funkt ein selbst gehostetes Hoard nach Hause?

Nein. Die Desktop-App spricht mit der Serveradresse, die du ihr gibst. Deine Stände, deine Nutzer und deine Logs bleiben auf deiner Maschine, und nichts davon erreicht uns.

Ist der selbst gehostete Server derselbe Code wie Hoard Cloud?

Ja, dasselbe hoard-server-Binary unter AGPL-3.0. Es gibt keine abgespeckte Community-Edition und keine Funktion, die der gehosteten Version vorbehalten wäre.

Wo liegen die Spielstände tatsächlich?

Standardmäßig in dem Docker-Volume, das du dem Container gibst, auf deiner eigenen Platte. Wenn du bereits Objektspeicher betreibst, spricht der Server auch S3 — MinIO, Garage oder Backblaze B2 funktionieren als Ablage. So oder so sprechen deine Geräte ausschließlich mit deinem Server.

Läuft das auf einem NAS?

Ja, auf jedem NAS mit Docker. Auf einem Synology folgst du den Schritten für Container Manager oben; für Unraid enthält das Repository eine Vorlage. In beiden Fällen wechselt das Image auf die PUID/PGID, die du angibst, damit eingebundene Ordner dem richtigen Benutzer gehören statt root.

Brauche ich Domain und HTTPS?

Im eigenen LAN nicht. Sobald der Server von außen erreichbar ist, gehört ein Reverse Proxy davor, der TLS terminiert — Caddy, nginx oder Traefik.

Was, wenn mein Server aus ist, wenn ich aufhöre zu spielen?

Der Snapshot entsteht lokal, es geht also nichts verloren. Er wird von selbst hochgeladen, sobald der Server wieder antwortet.

Kann ich mit Hoard Cloud anfangen und später wechseln?

Ja, in beide Richtungen. Über die Kontoseite lässt sich alles exportieren, und die App kann ohne Neuinstallation auf einen anderen Server zeigen.