So installierst Du Ralph Loop auf einem VPS

Wenn Du Anwendungen wie Ralph Loop auf einem VPS ausführst, kannst Du Deine Serverumgebung flexibel steuern und nach Bedarf skalieren. Egal, ob Du die Leistung optimieren, die Sicherheit aufrechterhalten oder mehr Kontrolle haben möchtest, als es bei einem typischen Shared Hosting möglich ist, ein VPS bietet Dir die Grundlage dafür.

In diesem Artikel gehen wir den Prozess der Installation von Claude Code und Ralph Loop auf Deinem VPS durch und behandeln alles von der Einrichtung des Servers bis zum reibungslosen Betrieb der Anwendung. Am Ende hast Du eine voll funktionsfähige Instanz, die Du nach Deinen eigenen Vorstellungen nutzen und verwalten kannst.

Was ist Ralph Loop

Ralph Loop, basierend auf Geoffrey Huntleys Ralph-Wiggum-Technik, ist ein iteratives Entwicklungsmuster, das dafür sorgt, dass Claude so lange an einer Aufgabe arbeitet, bis sie wirklich abgeschlossen ist.

Ralph Loop und VPS-Installation verstehen

Ralph Loop ist eine serverbasierte Plattform, die kontinuierlich läuft und Aufgaben oder Workflows auf Systemebene verarbeiten kann. Daher sind eine konsistente Leistung und eine sichere Datenverarbeitung unerlässlich. Wenn Du sie auf einem self-managed Server hostest, kannst Du die Umgebung konfigurieren, Updates steuern und Daten nach Bedarf verwalten.

Die Bereitstellung auf einem VPS bietet eine dedizierte Umgebung, die für diese Anforderungen geeignet ist. Im Gegensatz zu Shared Hosting ermöglicht ein VPS die notwendigen Hintergrundprozesse, benutzerdefinierten Konfigurationen und Einstellungen auf Systemebene, die für eine reibungslose Installation erforderlich sind. Außerdem ermöglicht es die Zuweisung von Ressourcen, die Konfiguration von Firewalls und optionale Containerisierung, wodurch die Plattform mit zunehmender Nutzung stabiler und skalierbarer wird.

Systemanforderungen für Ralph Loop

Bevor Du Ralph Loop auf einem VPS installierst, solltest Du sicherstellen, dass Dein Server die folgenden Anforderungen erfüllt, um eine reibungslose Bereitstellung zu gewährleisten:

• Betriebssystem: Linux-basiert, vorzugsweise Ubuntu LTS, aus Gründen der Kompatibilität und des langfristigen Supports.
• RAM: Mindestens 2 GB für eine grundlegende Bereitstellung; 4 GB oder mehr werden für höhere Arbeitslasten oder gleichzeitige Prozesse empfohlen.
• CPU: Mindestens 2 CPU-Kerne; mehr Kerne verbessern die Leistung bei aufgabenintensiven oder Mehrbenutzer-Setups.
• Speicher: SSD-Speicher von mindestens 20 GB; je nach Datenverarbeitungsanforderungen wird eine größere Kapazität empfohlen.
• Netzwerk: Stabile Internetverbindung mit ausreichender Bandbreite, um externe Anfragen und Updates zu verarbeiten.
• Abhängigkeiten: Zugriff auf die Installation von Docker, Python und anderen von Ralph Loop benötigten Systempaketen.

Wenn Du den Server schlank hältst und Dich auf die wesentlichen Komponenten konzentrierst, kannst Du die Reaktionsfähigkeit aufrechterhalten und das Risiko von ressourcenbezogenen Problemen verringern.

Auswahl des richtigen VPS-Hosting-Anbieters

Bei der Auswahl eines VPS-Anbieters für Ralph Loop solltest Du Dich auf Zuverlässigkeit und Leistung konzentrieren. Suche nach Anbietern mit starken Verfügbarkeitsgarantien und SSD-Speicher, da diese dazu beitragen, dass Hintergrundprozesse und Arbeitsabläufe reibungslos und ohne Unterbrechungen ablaufen. Auch die Flexibilität der Ressourcen ist wichtig: Die Möglichkeit, RAM, CPU oder Speicher bei steigender Nutzung zu erweitern, verhindert Leistungsengpässe und macht eine spätere Migration Deiner Konfiguration überflüssig.

Die Netzwerkqualität und der Standort des Servers spielen ebenfalls eine wichtige Rolle. Eine stabile Verbindung mit geringer Latenz trägt dazu bei, einen konsistenten Zugriff aufrechtzuerhalten, insbesondere bei der Interaktion mit externen Diensten oder bei der Einbindung mehrerer Benutzer. Die Wahl eines Rechenzentrums in der Nähe Deiner Hauptzielgruppe kann die Reaktionsfähigkeit verbessern, während Du gleichzeitig sicherstellen kannst, dass der Anbieter die erforderlichen Abhängigkeiten unterstützt und Docker eine reibungslose Installation und einen kontinuierlichen Betrieb gewährleistet.

Installieren von Ralph Loop auf einem VPS

Teil 1: Bereite Deinen VPS vor

Schritt 1: Verbinde Dich per SSH mit Deinem VPS

Verbinde Dich mit Deinem Server als Root-Benutzer, um die Einrichtung zu starten. Damit hast Du die nötigen Berechtigungen, um das System zu konfigurieren.

ssh root@your-vps-ip

Schritt 2: Aktualisiere das System

Durch die Aktualisierung Deines Servers stellst Du sicher, dass alle Pakete auf dem neuesten Stand sind, und verringerst das Risiko von Konflikten während der Installation.

apt update && apt upgrade -y

Schritt 3: Erstelle einen Nicht-Root-Benutzer

Die Ausführung von Ralph Loop als Nicht-Root-Benutzer erhöht die Sicherheit. In diesem Schritt wird ein Benutzer namens „agent” erstellt und mit sudo-Rechten ausgestattet.

adduser agent
usermod -aG sudo agent
su - agent

Schritt 4: Installiere tmux

Mit tmux kannst Du es in einer Sitzung ausführen, die auch dann weiterläuft, wenn Du die Verbindung zum VPS trennst.

sudo apt install -y tmux

Schritt 5: Installiere Node.js 20

Node.js ist nötig, um Ralph Loop und Claude Code auszuführen. Damit installierst Du Version 20, die empfohlene Version.

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Überprüfe die Installation:

node -v
npm -v

Schritt 6: Git installieren

Git wird für die Versionskontrolle und das Projektmanagement gebraucht. Richte Deine globalen Benutzerinformationen für Commits ein.

sudo apt install -y git
git config --global user.name „Dein Name“
git config --global user.email „you@example.com“

Schritt 7: Installiere jq

jq wird zum Parsen von prd.json-Dateien benötigt. Damit wird sichergestellt, dass JSON-Daten in Skripten korrekt verarbeitet werden.

sudo apt install -y jq

Überprüfe die Installation:

jq --version

Teil 2: Claude Code installieren und authentifizieren

Für Claude Code brauchst Du ein kostenpflichtiges Anthropic-Konto (Claude Pro oder höher). Stell sicher, dass Dein Konto funktioniert und die Daten aktualisiert sind, bevor Du weitermachst, um Probleme bei der Authentifizierung zu vermeiden.

Wenn Du noch kein Konto hast, geh auf claude.ai und suche dir ein passendes Angebot aus.

Schritt 1: Claude Code installieren

Installiere Claude Code global auf Deinem VPS. Mit sudo stellst Du sicher, dass Du die Berechtigung hast, systemweite Pakete zu installieren.

sudo npm install -g @anthropic-ai/claude-code

Überprüfe die Installation:

claude --version

Schritt 2: Claude Code auf Deinem VPS authentifizieren

Da der VPS keinen Browser hat, wird die Authentifizierung durch Öffnen einer URL auf Deinem lokalen Rechner durchgeführt.

claude

Claude Code zeigt im Terminal eine Themenauswahl an. Damit legst Du den visuellen Stil für die Sitzung fest.

Wähle den Textstil, der am besten zu Deinem Terminal passt, und drücke die Eingabetaste, um fortzufahren.

Schritt 3: Authentifizierung über den Browser

Kopiere die in Deinem Terminal angezeigte URL und öffne sie in einem Browser auf Deinem lokalen Rechner. Melde Dich mit Deinem Anthropic-Konto an und genehmige die Authentifizierung. Dadurch wird Deine VPS-Sitzung mit dem Claude Pro-Konto verknüpft.

Schritt 4: Anmeldung bestätigen

Nach der Authentifizierung zeigt das VPS-Terminal eine Willkommensnachricht mit Deinem Namen und Deinen Kontoinformationen an. Damit ist die Anmeldung erfolgreich abgeschlossen.

Willkommen zurück, [dein Name]!
Sonnet 4.6 · Claude Pro · your@email.com's Organization

Geh zurück zum Terminal, um die Einrichtung fortzusetzen. Drück Strg+C

Schritt 5: Authentifizierung überprüfen

Führe Folgendes aus, um sicherzustellen, dass alle Prüfungen bestanden wurden und Claude Code einsatzbereit ist:

claude doctor

Alle Prüfungen sollten bestanden sein. Dein VPS ist jetzt bereit für die Ausführung von Ralph Loop.

Teil 3: Ralph installieren

Schritt 1: Ralph-Repository klonen

Klon das Ralph-Repository an einen temporären Speicherort auf Deinem VPS. So bekommst Du Zugriff auf die benötigten Skripte und Dateien.

git clone https://github.com/snarktank/ralph.git /tmp/ralph

Schritt 2: Projekt-Skriptverzeichnis erstellen

Richte die Ordnerstruktur in Deinem Projekt ein, um die Skripte zu speichern.

mkdir -p ~/ralph-demo/scripts/ralph

Schritt 3: Kopiere die erforderlichen Dateien

Kopiere nur die Dateien, die für die Claude Code-Integration benötigt werden (ralph.sh und CLAUDE.md), in Dein Projektverzeichnis.

cp /tmp/ralph/ralph.sh ~/ralph-demo/scripts/ralph/
cp /tmp/ralph/CLAUDE.md ~/ralph-demo/scripts/ralph/
chmod +x ~/ralph-demo/scripts/ralph/ralph.sh

Schritt 4: Temporäres Repository entfernen

Lös nach dem Kopieren der erforderlichen Dateien den temporären Klon, um Deinen Server sauber zu halten.

rm -rf /tmp/ralph

Schritt 5: Dateien überprüfen

Überprüfe, ob die kopierten Dateien vorhanden sind und die richtigen Berechtigungen haben.

ls ~/ralph-demo/scripts/ralph/

Erwartete Ausgabe:

CLAUDE.md ralph.sh

Teil 4: Demo-Projekt erstellen

Schritt 1: Zu Deinem Projektordner navigieren und Git initialisieren

Geh in Dein Projektverzeichnis und richte ein Git-Repository ein. Ralph Loop nutzt den Git-Verlauf, um Änderungen zu verfolgen und seinen Workflow zu verwalten.

cd ~/ralph-demo
git init

Schritt 2: Erstellen von prd.json mit Demo-Aufgaben

Ralph liest Aufgaben aus prd.json. Jede Aufgabe sollte klein und fokussiert sein, damit sie in einem einzigen Kontextfenster erledigt werden kann. Große Aufgaben können zu unvollständigen Ergebnissen führen.

nano prd.json

Füge Folgendes ein:

{
„branchName“: „feature/express-demo“,
„userStories“: [
{
„id“: 1,
„title“: „Node-Projekt initialisieren“,
‚description‘: „package.json erstellen und express installieren“,
„passes“: false
},
{
„id“: 2,
„title“: „Express-Server erstellen“,
‚description‘: „Homepage auf Port 3000 bereitstellen“,
„passes“: false
},
{
„id“: 3,
„title“: „Homepage-Inhalt hinzufügen“,
‚description‘: „‚Autonom erstellt von Ralph Loop 🚀‘ anzeigen“,
„passes“: false
}
]
}

Hinweis: Das Feld „branchName“ sagt Ralph, welchen Git-Zweig er erstellen und committen soll. Jede neue Funktion sollte einen anderen Zweignamen verwenden, und frühere Durchläufe werden automatisch archiviert.

Schritt 3: Speicher-Dateien erstellen

Ralph nutzt „progress.txt“ und „AGENTS.md“, um Speicher über Iterationen hinweg zu übertragen. Erstelle diese Dateien, damit er Erkenntnisse und Muster für Dein Projekt speichern kann.

touch progress.txt

Schritt 4: Erstelle einen ersten Commit

Zum Starten ist mindestens ein Commit erforderlich. Dieser dient als Grundlage für den autonomen Betrieb.

git add .
git commit -m „Initial project setup”

Teil 5: Ralph ausführen

Schritt 1: Eine tmux-Sitzung starten

Starte Ralph in einer tmux-Sitzung, damit es auch dann weiterläuft, wenn Deine SSH-Verbindung unterbrochen wird.

tmux new -s ralph

Schritt 2: Zum Projektverzeichnis navigieren

Geh zum Projektordner.

cd ~/ralph-demo

Schritt 3: Führe die Schleife mit Claude Code aus

Starte Ralph Loop und gib das Claude Code-Tool zusammen mit der Anzahl der auszuführenden Iterationen an.

./scripts/ralph/ralph.sh --tool claude 10

Dadurch wird Ralph angewiesen, Claude Code zu verwenden und bis zu 10 Iterationen für die Ausführung zuzulassen.

Trenn die Sitzung, damit Ralph im Hintergrund weiterläuft, während du andere Aufgaben erledigst.

Strg+B, dann D

Schritt 4: Überprüfe, ob Ralph läuft

Schau nach, ob die tmux-Sitzung aktiv ist:

tmux ls

Erwartete Ausgabe:

ralph: 1 Fenster (erstellt …)

Stell sicher, dass Ralph in der tmux-Sitzung noch aktiv ist, was bedeutet, dass er im Hintergrund läuft.

Teil 6: Überprüfen, ob Ralph funktioniert

Schritt 1: Git-Commits überprüfen

Schau nach, ob Ralph angefangen hat, Commits für erledigte Aufgaben zu machen. Das zeigt, dass es die Aufgaben aus prd.json richtig verarbeitet.

cd ~/ralph-demo
git log --oneline

Erwartete Ausgabe:

a13f9c1 Node-Projekt initialisieren
b72d221 Express-Server erstellen
c991f41 Inhalt zur Startseite hinzufügen

Schritt 2: Aufgabenstatus überprüfen

Verwende jq, um prd.json zu überprüfen und zu sehen, welche Aufgaben erledigt wurden. Ralph setzt „passes” auf „true”, sobald eine Aufgabe fertig ist.

cat prd.json | jq ‚.userStories[] | {id, title, passes}‘

Beispielausgabe nach Abschluss der Aufgaben:

{ „id“: 1, „title“: „Node-Projekt initialisieren“, „passes“: true }
{ „id“: 2, ‚title‘: „Express-Server erstellen“, „passes“: true }
{ „id“: 3, ‚title‘: „Homepage-Inhalt hinzufügen“, „passes“: true }

Schritt 3: Überprüfe Ralphs Erkenntnisse

Ralph fügt projektspezifische Erkenntnisse zu progress.txt hinzu. Wenn Du diese Datei anschaust, siehst Du die während der Ausführung gesammelten Erkenntnisse.

cat progress.txt

Schritt 4: Endgültige Ausgabe ansehen

Verbinde Dich wieder mit der tmux-Sitzung, um zu sehen, ob sie in Echtzeit läuft:

tmux a -t ralph

Wenn alle userStories passes: true haben, gibt Ralph aus, dass er alles selbstständig erledigt hat.

Teil 7: Die App öffentlich zugänglich machen

Dein Terminal ist jetzt beschäftigt, während die App läuft. Öffne ein zweites Terminal auf Deinem lokalen Rechner, verbinde Dich wieder per SSH mit Deinem VPS und mach mit den folgenden Schritten weiter.

Schritt 1: Nginx installieren

Nginx fungiert als Reverse-Proxy, leitet HTTP-Anfragen an Deine Node.js-Anwendung weiter und ermöglicht den öffentlichen Zugriff.

sudo apt install -y nginx

Schritt 2: Teste Deiner App

Führe die Node.js-Anwendung aus, um sicherzustellen, dass sie korrekt startet, und konfiguriere dann Nginx.

cd ~/ralph-demo
node index.js

Erwartete Ausgabe:

Server läuft auf http://localhost:3000

Schritt 3: Konfiguriere Nginx als Reverse-Proxy

Schreib die Nginx-Konfiguration in einem Befehl, um den Datenverkehr von Port 80 an Deine Node.js-App weiterzuleiten, die auf Port 3000 läuft.

sudo tee /etc/nginx/sites-available/default > /dev/null << ‚EOF‘
server {
listen 80;
server_name _;
location / {
proxy_pass http://localhost:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection ‚upgrade‘;
proxy_set_header Host $host;
}
}
EOF

Überprüfe, ob die Konfiguration richtig aussieht:

cat /etc/nginx/sites-available/default

Starte Nginx neu, um die Änderungen zu übernehmen:

sudo systemctl restart nginx

Schritt 4: Halte die App mit PM2 am Laufen

Nutze PM2, um die Node.js-Anwendung als Hintergrundprozess auszuführen und sicherzustellen, dass sie bei einem Neustart des Servers wieder gestartet wird.

sudo npm install -g pm2
pm2 start /home/agent/ralph-demo/index.js --name ralph-demo
pm2 save
pm2 startup

Überprüfe, ob die App läuft:

pm2 status

Erwartete Ausgabe: ralph-demo sollte online anzeigen.

Schritt 5: Öffne die App in Deinem Browser

Ruf die IP-Adresse Deines VPS in einem Browser auf, um zu überprüfen, ob die App zugänglich ist:

http://your-vps-ip

Erwarteter Inhalt:

Autonom erstellt von Ralph Loop

Diese Seite wurde komplett durch den autonomen Loop erstellt, der in tmux läuft, ohne dass manuell programmiert werden musste.

Laufende Wartung und Updates

Wenn Du eine selbst gehostete Ralph Loop-Instanz hast, musst Du sowohl Deinen Server als auch Deine Anwendung auf dem neuesten Stand halten. Installiere regelmäßig Sicherheitspatches und System-Updates auf Deinem Linux-VPS, um Schwachstellen zu reduzieren. Wenn Du Docker oder andere containerisierte Komponenten verwendest, solltest Du die Images regelmäßig aktualisieren, um die neuesten Fehlerbehebungen und Verbesserungen zu erhalten.

Genauso wichtig ist es, die Ressourcen Deines Servers zu überwachen. Beobachte die CPU-Auslastung, den Speicherverbrauch und den Festplattenspeicher, um Leistungsprobleme zu vermeiden, bevor sie sich auf Ralph Loop auswirken. Wenn Dein Arbeitsaufwand steigt, kannst Du durch eine Aufrüstung Deiner VPS-Ressourcen, z. B. durch Hinzufügen von RAM, CPU-Kernen oder Speicherplatz, sicherstellen, dass die Anwendung weiterhin reibungslos und ohne Unterbrechungen läuft. Durch regelmäßige Wartung bleibt Deine Bereitstellung sicher, stabil und langfristig skalierbar.

Fazit

Durch die Installation von Ralph Loop auf einem VPS hast Du die volle Kontrolle über Deine Umgebung und die Flexibilität, diese entsprechend Deinen Anforderungen zu skalieren. Durch die richtige Vorbereitung des Linux-Servers, dessen Sicherung, die Installation der erforderlichen Abhängigkeiten und die sorgfältige Befolgung der Bereitstellungsschritte stellst Du sicher, dass Ralph Loop zuverlässig und effizient läuft.

Ein gut konfigurierter VPS bietet konsistente Verfügbarkeit, reibungslose Leistung und volle Kontrolle über Deine Infrastruktur. In Verbindung mit regelmäßiger Überwachung und Wartung bietet diese Konfiguration eine stabile, sichere und langfristige Plattform für den autonomen Betrieb von Ralph Loop.

Artikel von

Frederick Schiwek

Hallo! Ich bin Freddy, Autor und Mitglied des Teams von hosting.de. Mit über 20 Jahren Erfahrung im Hosting-Business schreibe ich über Technologie, das Internet und die Zukunft der digitalen Infrastruktur. Ob Domains, Hosting oder Cloud-Dienste – ich bin hier, um Einblicke und Ideen zu teilen!