Schnellstart (nur im Lab)
Das ist der Weg, den ein neuer Nutzer geht: ein Server für den Kern, ein leerer Server als Node, dein Telefon mit der
Freigabe-App und ein Coding-Agent. Du arbeitest im Allein-Modus: Solange du die einzige Person bist, die freigeben
kann, gibst du frei, was dein eigener Agent vorschlägt. Das Lab-Skript lab/local/quickstart.sh geht genau diesen Weg;
es braucht sechs menschliche Schritte und knapp zwei Minuten.
Was du brauchst
Abschnitt betitelt „Was du brauchst“Gemessen am 2026-11-06 auf arm64, Ubuntu 24.04, mit 20 Ops:
| Rolle | Mindestens | Bequem | Gemessen |
|---|---|---|---|
| Kern | 1 GB RAM | 2 GB RAM | vaicoa-core 51–59 MB im Betrieb, kurz nach dem Start bis 226 MB (Entsperren der Schlüssel); mit Treibern rund 200–360 MB |
| Node | 512 MB RAM plus deine Workloads | 1 GB plus Workloads | vaicoa-node 73–77 MB, je Container gut 1 MB für conmon |
| Kern mit dem Kubernetes-Plug-in | 1 GB | 2 GB | das Plug-in kostet rund 25 MB; Cluster-Server brauchen, was k3s braucht, plus 50–80 MB für den Node |
| Alles auf einer Maschine (k3s-Server, Kern mit Plug-in, Node) | 4 GB RAM | 8 GB RAM | Vaicoa zusammen 165–337 MB; k3s selbst rund 970 MB, typische Zusätze rund 400 MB |
Der größte Teil der 4–8 GB ist k3s, nicht Vaicoa. Ein 24-Stunden-Dauertest steht noch aus.
Schritte
Abschnitt betitelt „Schritte“-
Installiere den Kern auf dem Server (Ubuntu oder Debian):
Terminal-Fenster sudo apt install ./vaicoa-core_*_arm64.debDer Kern kommt ohne Kubernetes-Unterstützung. Für k3s, Kubernetes und Cluster API installierst du zusätzlich
vaicoa-plugin-kubernetes(gleiche Version), dannsudo systemctl reload vaicoa-core. Ohne das Plug-in werden dessen Aktionen als nicht verfügbar angezeigt, und der Kern lehnt sie ab, bevor er jemanden fragt. -
Richte den Kern ein (menschlicher Schritt 1 von 6):
Terminal-Fenster sudo vaicoa-core init --quickstart --public-url https://HOSTDas legt die Schlüssel, den Katalog, die Policy und die systemd-Unit an und startet den Kern. Das Terminal zeigt einen QR-Code mit Kurzlink, den Einzeiler für deinen ersten Node und eine Checkliste. Der Allein-Modus ist an; mit
--solo=falsebleibt er aus. -
Werde der erste Owner (Schritt 2): Scanne den QR-Code mit der Freigabe-App. Die App zeigt „Du bist der erste Owner“ mit dem CA-Fingerprint und „Allein-Modus an“. Prüfe die Angaben und bestätige einmal mit Face ID oder Fingerabdruck. Damit ist das Telefon gekoppelt und der erste Roster signiert. Weicht der Roster des Kerns von dem ab, was die App gezeigt hat, signiert die App nichts und zeigt ihn dir einzeln.
-
Melde einen Node an (Schritt 3): Führe den Einzeiler, den
initgedruckt hat, auf dem leeren Server aus. Er lädtvaicoa-nodegepinnt von deinem Kern, installiert Podman, meldet den Node an und startet ihn. Der Link gilt genau einmal. -
Verbinde einen Agenten (Schritte 4 und 5), auf dem Rechner des Agenten:
Terminal-Fenster vaicoa-run pair --core https://HOST:8444 --ca-sha256 <fingerprint> \--actions env.apply,env.deleteDas Telefon zeigt denselben Vergleichscode wie das Terminal. Stimmt er, lässt du den Agenten zu: schieben, dann Face ID.
-
Erste Freigabe (Schritt 6): Lass den Agenten etwas vorschlagen, zum Beispiel „Deploy nginx as web in demo“. Die App zeigt das Abzeichen „Allein-Modus: du gibst deinen eigenen Agenten frei“. Lies die Fakten, schiebe und bestätige. Der Container läuft auf dem Node, und im Verlauf steht die Op mit
solo.
Was der Allein-Modus nicht ändert
Abschnitt betitelt „Was der Allein-Modus nicht ändert“Face ID, Schieben, Auswählen oder Eintippen bei destruktiven Aktionen bleiben; ebenso Ablaufzeiten, Pläne und jede
Prüfung auf dem Node. Was du selbst direkt vorschlägst, braucht weiterhin eine zweite Person. Unter dem Profil
starter steht der Allein-Modus in vaicoa-core check als RELAXED, unter standard als WEAKENED; unter strict
startet der Kern damit nicht.
Lädst du ein zweites Mitglied mit der Owner- oder Operator-Rolle ein, endet der Allein-Modus mit genau dieser Roster-Änderung, und ab dann gilt das Vier-Augen-Prinzip.
Backup des Kerns
Abschnitt betitelt „Backup des Kerns“Ein verschlüsseltes Backup (AES-256-GCM, Schlüssel per Argon2id aus deiner Passphrase abgeleitet) in eine Datei oder einen S3-Bucket:
sudo vaicoa-core backup --config /var/lib/vaicoa/core.yaml \ --to s3://BUCKET/vaicoa --passphrase-file /root/backup-pass \ --s3-credentials-file /root/s3.env --retention 7d,4wsudo vaicoa-core backup verify --from s3://BUCKET/vaicoaBewahre die Passphrase in deinem Passwort-Manager auf, nicht auf dem Server, und schalte im Bucket Object Lock ein.
Andere Einstiege
Abschnitt betitelt „Andere Einstiege“- Nur die App, ohne Kern (rund 10 Minuten): ein Fake-Kern auf einem Mac und die Android-App im Emulator.
- Voll automatisiert (rund 15 Minuten):
lab/local/up.shund danachlab/local/e2e.shbauen auf lokalen VMs einen Kern, zwei Nodes und zwei Personen auf und spielen Kopplung, Vier-Augen-Freigabe, Plan-Drift, Agenten und Profile durch.
Beide stehen im Handbuch (docs/handbuch.md, „Schnellstart“ A und B).