Arc OS Docs Open in app →

Standard-Cloud-Leitfaden

Der Starter-Cloud-Tarif beinhaltet einen dedizierten Docker-Container für dein AI-Team. Dieser Leitfaden behandelt Provisionierung, Terminal-Zugriff, GitHub-Einrichtung und Lifecycle-Management.

Was du erhältst

Einen dedizierten Ubuntu-22.04-Container auf Hetzner arc-cloud-prod (157.180.44.232):

Provisionierung

  1. Upgrade auf den Starter-Cloud-Tarif (Settings → Billing).
  2. Gehe zu Settings → Cloud Workspace.
  3. Klicke auf Provision Container — dauert ~30 Sekunden.
  4. Sobald der Status ready anzeigt, klicke auf Open Terminal.

Web-Terminal

Das Terminal ist eine vollwertige xterm.js-WebSocket-Session, die über den CRM-Server geproxyt wird. Du kannst ausführen:

arc <project>          # start a bridge session
claude -p "..."        # direct Claude call
git clone ...          # clone your repo into /workspace

Die Session nutzt dein CRM-JWT zur Authentifizierung — aus dem Browser sind keine SSH-Keys nötig.

Chat ↔ Cloud-Routing (Phase 70)

Nach der Provisionierung laufen Chat-Nachrichten aus dem CRM oder Telegram in deinem Container, nicht auf dem Master-Server. Der Worker startet claude -p in /workspace/<project>; Änderungen landen in deinen Bot-Org-Repos; Idle-Pause-Snapshots pushen die Arbeit zu GitHub. Vollständiger Leitfaden: cloud-chat-routing.md.

Repositories

Jedes Arc-OS-Projekt erhält automatisch ein privates Repo unter einer Bot-verwalteten GitHub-Organisation. Dein Cloud Workspace klont bei der Provisionierung jedes Projekt-Repo nach /workspace/<project> und pusht beim Pausieren einen Snapshot. Den Sync steuerst du von deinem Laptop aus über arc pull / arc push / arc cloud sync.

Das vollständige Modell — drei Repo-Typen (system / project / external), die Namenskonvention, Alltagsbefehle und der External-Repo-Flow — findest du in cloud-repos.md.

GitHub-SSH-Einrichtung (für externe Repos)

Die oben beschriebenen, von Arc OS automatisch verwalteten Repos benötigen keinerlei Einrichtung — sie authentifizieren sich über ein kurzlebiges Installationstoken, das automatisch nach ~/.git-credentials geschrieben wird. Die folgende SSH-Einrichtung ist nur nötig, wenn du deine eigenen privaten GitHub-Repos als externe Einträge im Repositories-Panel klonen möchten:

  1. Klicke unter Settings → Cloud Workspace auf GitHub SSH Setup.
  2. Arc OS generiert ein Ed25519-Schlüsselpaar im Container.
  3. Kopiere den in der UI angezeigten öffentlichen Schlüssel.
  4. Füge ihn unter GitHub → Settings → SSH and GPG keys → New SSH key hinzu.
  5. Teste mit ssh -T [email protected] im Terminal.

Inaktivität & Fortsetzung

Container pausieren automatisch nach 30 Minuten Inaktivität (ein Cron läuft alle 5 Min. auf dem API-Server). Das ist beabsichtigt — ein pausierter Container kostet $0 an Rechenleistung.

Zum Fortsetzen:

Das Fortsetzen dauert ~2-3 Sekunden (Docker unpause).

Lifecycle-Zustände

Zustand Bedeutung
provisioning Container wird erstellt
ready Läuft, nimmt Verbindungen an
paused Wegen Inaktivität pausiert, wird bei Aktivität fortgesetzt
suspended Manuell ausgesetzt oder Zahlungsverzug
deleted Deprovisioniert (Kündigung)

Kündigung

Wenn du Starter Cloud kündigst:

Zur Reaktivierung upgradest du wieder auf Starter Cloud — ein neuer Container wird provisioniert.

Sicherheit