Hivekeep
DE
Konfigurieren
Installation

Bring Hivekeep zum Laufen.

Ein Befehl erledigt alles. Sobald es läuft, richtet Queenie den Rest im Chat mit dir ein, du musst also keine Config-Dateien anfassen.

Empfohlen · der einfachste Weg

Eine Zeile einfügen. Fertig.

Führe das in einem Terminal auf deiner Linux- oder macOS-Maschine aus. Es installiert alles für dich.

curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

Wenn er fertig ist, öffne den ausgegebenen Link im Browser. Queenie erledigt den Rest.

Optional

Eigener Port, eigene Domain oder Docker?

Überspring das, wenn der Einzeiler oben alles ist, was du brauchst. Sonst beantworte ein paar Fragen und wir generieren den exakten Befehl für dein Setup.

1 · Wie wirst du es nutzen?

2 · Einstellungen

3 · Ausführen

Installierenshell
curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

Um deinen Verschlüsselungsschlüssel wird sich gekümmert. Der Installer generiert ihn automatisch und speichert ihn unter $DATA_DIR/.encryption-key, damit deine Secrets Neustarts überleben. Sichere diese Datei zusammen mit deiner Datenbank. (Setze einen festen ENCRYPTION_KEY über den Schalter oben, wenn du ihn lieber selbst verwalten willst.)

Wenn die Installation fehlschlägt
  • port already in use / EADDRINUSE: Port 3000 ist belegt. Ändere oben das Port-Feld und führe es erneut aus.
  • Windows: Der Installer läuft nur unter Linux und macOS. Führe ihn in WSL2 aus oder nutze Docker Desktop.
  • Download oder Klonen hängt: Stell sicher, dass die Maschine github.com und bun.sh über HTTPS erreicht (vielleicht blockiert ein Proxy).

Öffne http://localhost:3000 in deinem Browser. Queenie führt dich durch den Rest (Admin-Konto, dein erster KI-Provider, deine ersten Agenten). Keine Config-Dateien zu bearbeiten.
Fortgeschritten & weitere Optionen Voraussetzungen, und Docker vs. nativ vs. Quellcode
Bevor du startest

Was der Einzeiler braucht.

Die meisten Maschinen haben das alles schon.

Du kannst sudo nutzen
Der Installer braucht es, um fehlende Systempakete zu installieren (git, curl, unzip).
Etwa 500 MB freier Speicher
Platz zum Klonen und Bauen. 1 GB oder mehr ist komfortabel.
Eine 64-Bit-Maschine
x86_64 oder ARM64. 32-Bit (ältere Raspberry Pi) wird nicht unterstützt.
Ausgehendes HTTPS
Es lädt von github.com und bun.sh herunter, die müssen also erreichbar sein.
openssl vorhanden
Wird zum Generieren von Schlüsseln genutzt. Ist bei fast jedem Linux und macOS dabei.

Auf Windows? Der native Installer läuft nicht direkt unter Windows. Nutze WSL2 (führe den Einzeiler in deiner Linux-Distro aus) oder Docker Desktop.

Vergleich

Nativ, Docker oder aus dem Quellcode?

Alle drei führen exakt dieselbe App aus. Sie unterscheiden sich darin, wie sie auf der Maschine lebt.

Empfohlen

Nativ (install.sh)

Nimm das, wenn es einfach funktionieren soll. Ein Befehl, auf deiner eigenen Linux- oder macOS-Maschine.

  • Ein Befehl, baut lokal, kein Image zu veröffentlichen oder zu ziehen
  • Speichert deinen Verschlüsselungsschlüssel automatisch, Secrets bleiben erhalten
  • Läuft als Dienst (systemd / launchd), Auto-Update mit Rollback
  • Agenten gehört die Maschine: Tools & Dependencies installieren, direkter Hardware-Zugriff
  • Verändert das Host-System (mit Absicht)
  • Nur Linux & macOS (Windows über WSL2)
Container

Docker

Nimm das, wenn du sowieso in Docker lebst und eine saubere, isolierte Appliance willst.

  • Voll isoliert, null Müll auf dem Host
  • Läuft überall, wo Docker läuft, auch unter Windows
  • Das veröffentlichte Image ist noch nicht verfügbar, nimm vorerst lieber nativ
  • Von Agenten installierte Tools & Binaries überleben keinen Neustart
  • Du musst das Daten-Volume persistieren, sonst verlierst du deine Secrets
Aus dem Quellcode

Manuell

Nimm das, wenn du den Code lesen, daran basteln oder ihn auf deine Art betreiben willst.

  • Volle Kontrolle: selbst klonen, bauen und mit Bun starten
  • Am besten für Contributors und Entwicklung
  • Kein Dienst, kein Auto-Update, das verkabelst du selbst
  • Bun, Build, Migrationen und den Verschlüsselungsschlüssel managst du von Hand