Ein Rechner, der laufen bleibt
Sie brauchen einen Linux-Server mit Debian oder Ubuntu, Node.js ab Version 22 und git. Ein Reverse-Proxy wie Caddy ist nur für eine öffentliche HTTPS-Adresse nötig.
Docs
Voraussetzungen und aktuelle Befehle, um Beluga als dauerhaften Dienst auf einem Linux-Server zu installieren und Claude, Codex oder Cursor über die Oberfläche zu verbinden.
Das Archiv läuft über das Unterstützungsfenster. Derselbe Code kann weiterhin frei aus dem öffentlichen Repository geklont werden.
Erste Schritte
Die Installation in sechs Befehlen
Führen Sie sie der Reihe nach auf einem Linux-Server aus. Sie klonen das öffentliche Repository, bauen die Anwendung, erstellen den Zugang und installieren Dienst und Überwachung.
git clone https://github.com/haikostudio/belugabuildtool.git beluga cd beluga npm install npm run build node scripts/set-credentials.mjs sudo scripts/installer-services.sh
Beluga lauscht danach lokal auf 127.0.0.1:7070. Ein Reverse-Proxy wie Caddy kann es mit HTTPS unter Ihrer Domain zugänglich machen.
Das öffentliche Repository
Das öffentliche Repository lässt sich ohne Einladung per HTTPS klonen. Das hier angebotene Archiv enthält dasselbe Projekt für den direkten Download.
Ein KI-Werkzeug auf Ihrem Server
Installieren Sie mindestens ein unterstütztes Kommandozeilenwerkzeug: Claude Code, Codex oder Cursor. Der Startassistent zeigt, was auf der Maschine fehlt.
Ihre eigenen Konten
Verbinden Sie Claude oder Codex über die Oberfläche oder fügen Sie einen Cursor-Schlüssel hinzu. Mehrere Konten einer Engine können die Arbeit nach Verfügbarkeit teilen.
Fehlerbehebung
Wenn es klemmt
Die drei häufigsten Pannen, jeweils in einer Zeile beantwortet.
Der Dienst startet und stoppt sofort wieder
Lesen Sie Zustand und Protokolle mit systemctl und journalctl, um den blockierenden Pfad, Benutzer oder die Abhängigkeit zu finden.
Der Build bricht mit „tsc: not found" ab
Installieren Sie mit NODE_ENV=development npm install --include=dev neu und starten Sie danach npm run build erneut.
Keine Engine ist bereit
Der Startassistent zeigt, ob das Werkzeug fehlt oder das Konto neu verbunden werden muss. Folgen Sie dem angezeigten Befehl und kehren Sie zur Oberfläche zurück.
Bereit zur Installation?
Laden Sie das Archiv herunter oder klonen Sie das öffentliche Repository und folgen Sie den sechs Befehlen der Reihe nach.