CrewDoku
Loslegen

Schnellstart: Server (Hetzner)

Vom Hetzner-Konto bis zur ersten Antwort deiner Crew auf dem Handy — ein Befehl, drei Fragen.

Das brauchst du: ein Hetzner-Konto, eine Domain (z. B. bei IONOS, Strato, INWX), dein Handy. SSH und DNS musst du nicht kennen — alles wird unten erklärt. Das hast du am Ende: Crew läuft auf deinem Server unter crew.deinedomain.de, verborgen hinter einem verschlüsselten Relay, und dein Handy ist gekoppelt. Dauer: etwa 15 Minuten.

1 · Server anlegen

In der Hetzner Console → Projekt → Server hinzufügen:

  • Standort: Falkenstein oder Nürnberg
  • Image: Ubuntu 24.04
  • Typ: CAX21 (4 vCPU Arm, 8 GB RAM) oder CX32 — Empfehlung für bis zu 5 Agenten mit Browser
  • SSH-Schlüssel: hinzufügen, wenn du einen hast (sonst schickt Hetzner ein Root-Passwort per Mail)

Notiere die IPv4-Adresse des Servers.

Ohne Terminal? Füge unter Cloud config diesen Block ein, dann richtet sich der Server beim ersten Start selbst ein und du überspringst Schritt 3:

#cloud-config
runcmd:
  - curl -fsSL https://crewd.team/install.sh | sh -s -- --server --yes --domain crew.deinedomain.de --visibility hidden --setup-code DEIN-CODE-MIN-12-ZEICHEN

Den Einrichtungscode wählst du selbst (mindestens 12 Zeichen). Er gilt nur bis zum ersten gekoppelten Gerät, höchstens 24 Stunden.

2 · Domain auf den Server zeigen lassen

Bei deinem Domain-Anbieter einen A-Eintrag anlegen: Name crew, Wert = IPv4 des Servers. Details je Anbieter: Eigene Domain verbinden.

3 · Der eine Befehl

Im Terminal (Mac: Programme → Dienstprogramme → Terminal):

ssh root@<IPv4 des Servers>
curl -fsSL https://crewd.team/install.sh | sh

Der Installer fragt vier Dinge:

  1. Wie soll Crew erreichbar sein? → Eigene Domain, dann crew.deinedomain.de
  2. Wie sichtbar soll der Server sein? → Verborgen (Empfehlung, siehe Sichtbarkeit)
  3. Wo sollen deine Daten zu Hause sein? → Auf diesem Server
  4. Claude verbinden (nachdem der Dienst läuft) → auf deinem Mac/PC claude setup-token ausführen und das Token einfügen. Crew legt es verschlüsselt im Tresor ab und prüft es mit einem kurzen Testlauf. Leer lassen überspringt den Schritt; nachholen kannst du ihn mit sudo crewd setup oder in der App unter Einstellungen → Modelle & Anmeldung → Claude. Ohne Rückfragen: --claude-token sk-ant-….

Erwartet (gekürzt):

✓ Ubuntu 24.04 · arm64 · 8 GB RAM · 71 GB frei
✓ Docker 28
✓ DNS zeigt auf diesen Server
✓ Images geladen
✓ Dienst läuft · Backup täglich 03:30 · Firewall an
✓ Von außen geprüft: nur /relay antwortet
◇ Claude verbinden
✓ Claude verbunden

Fertig.
Koppel jetzt ein Gerät (10 Minuten gültig):
  Mac:    crew://pair#K7QF-9XM2-PL4T@crew.deinedomain.de  (anklicken)
  Handy:  QR unten scannen
  Code:   K7QF-9XM2-PL4T

Ohne Domain: über Tailscale

Wählst du bei der ersten Frage Tailscale, braucht der Server keine Domain und keine offenen Ports. Statt Caddy richtet crewd setup die HTTPS-Weiterleitung per tailscale serve ein: https://<name>.ts.net geht an crewd, https://<name>.ts.net/relay an den Relay. sudo crewd update prüft sie bei jedem Lauf und zieht sie nach.

Meldet der Installer „Tailscale-Weiterleitung nicht eingerichtet“ (oder crewd doctor den Befund D206), richtest du sie von Hand ein. Die Adresse von crewd steht als CREW_HOST und CREW_PORT in /opt/crew/crew.env, meist so:

sudo tailscale serve --bg --https=443 http://172.17.0.1:4317
sudo tailscale serve --bg --https=443 --set-path=/relay http://127.0.0.1:7447

Prüf die Adresse danach von einem anderen Gerät im Tailnet, nicht vom Server selbst: Läuft dort ein weiterer Dienst auf Port 443, landet der Aufruf der eigenen ts.net-Adresse bei ihm.

4 · Handy koppeln

Crew-App öffnen → QR-Code scannen. Fertig — schreib Lena.

Weitere Geräte (Mac, Windows, Browser) fügst du danach in der App hinzu: Einstellungen → Geräte → Verbinden. Jedes weitere Gerät musst du auf einem schon verbundenen bestätigen. Mehr: Geräte koppeln.

5 · Master-Key sichern

sudo crewd backup --key

Zeigt den Schlüssel, mit dem deine gespeicherten Zugänge verschlüsselt sind. Ausdrucken oder in den Passwort-Manager.

Wenn es nicht klappt

sudo crewd doctor

Jeder Befund hat einen Code und eine Hilfeseite, z. B. D204 · Domain zeigt nicht auf diesen Server. Die Einladung ist abgelaufen? sudo crewd pair erzeugt eine neue.

Auf dieser Seite