HitKeep mit Homebrew auf macOS und Linux installieren

Homebrew ist der kürzeste unterstützte Installationsweg für HitKeep unter macOS auf Apple Silicon und unter Ubuntu Linux auf AMD64 oder ARM64. Der offizielle Tap installiert die aktuelle stabile hitkeep-Binärdatei. HitKeep speichert seine Daten weiterhin lokal und verwendet dieselbe Konfiguration wie jede andere selbst gehostete Bereitstellung.

Plattform	Homebrew-Unterstützung
macOS ARM64 (Apple Silicon)	CI-validiert
Ubuntu Linux AMD64/x86_64	Mit Linuxbrew in CI validiert
Ubuntu Linux ARM64	Mit Linuxbrew in CI validiert

Die CI für Releases installiert auf jeder aufgeführten Plattform die stabile Formel, aktualisiert sie auf den Release Candidate, prüft die installierte Version, führt brew test aus und deinstalliert sie anschließend.

Schnellstart

Installiere HitKeep aus dem offiziellen Tap:

brew install PascaleBeier/hitkeep/hitkeep
hitkeep --version

Erstelle ausdrücklich persistente Verzeichnisse, erzeuge ein Sitzungsgeheimnis und starte eine lokale Instanz:

mkdir -p "$HOME/.local/share/hitkeep"/{data,archive,backups}

export HITKEEP_PUBLIC_URL=http://localhost:8080
export HITKEEP_JWT_SECRET="$(openssl rand -hex 32)"
export HITKEEP_BIND_ADDR=127.0.0.1:7946
export HITKEEP_DB_PATH="$HOME/.local/share/hitkeep/data/hitkeep.db"
export HITKEEP_DATA_PATH="$HOME/.local/share/hitkeep/data"
export HITKEEP_ARCHIVE_PATH="$HOME/.local/share/hitkeep/archive"
export HITKEEP_BACKUP_PATH="$HOME/.local/share/hitkeep/backups"

hitkeep

Öffne http://localhost:8080 und schließe den Einrichtungsassistenten ab.

Sitzungsgeheimnis dauerhaft speichern

Der obige Befehl ist für einen lokalen Schnellstart gedacht. Bevor du dich auf diese Instanz verlässt, speichere einen unveränderlichen HITKEEP_JWT_SECRET in einer zugriffsgeschützten Umgebungsdatei oder Dienstkonfiguration. Wenn bei jedem Start ein neues Geheimnis erzeugt wird, werden alle Benutzer abgemeldet.

Nutze die Konfigurationsreferenz für Produktions-URLs, E-Mail, Speicher, S3, MCP und optionale KI-Einstellungen.

Installation prüfen

Prüfe in einem weiteren Terminal die installierte Formel, führe den Formeltest des Taps aus und kontrolliere beide Laufzeitprüfungen:

brew list --versions hitkeep
brew test PascaleBeier/hitkeep/hitkeep
curl --fail http://localhost:8080/healthz
curl --fail http://localhost:8080/readyz

/healthz bestätigt, dass der Prozess läuft. /readyz bestätigt, dass die gemeinsame Datenbank und jede geöffnete Mandantendatenbank Anfragen verarbeiten können.

Upgrade

Lies die Release Notes, aktualisiere anschließend die Homebrew-Metadaten und führe das Upgrade der Formel aus:

brew update
brew upgrade hitkeep
brew list --versions hitkeep

Starte den laufenden HitKeep-Prozess nach dem Upgrade neu. Homebrew ersetzt die ausführbare Datei; die von dir konfigurierten Datenpfade werden weder verschoben noch gelöscht.

Backup

Der Schnellstart aktiviert HitKeeps Worker für konsistente Checkpoint-Backups unter $HOME/.local/share/hitkeep/backups. Lege dieses Verzeichnis auf dauerhaftem Speicher ab und teste eine Wiederherstellung, bevor du es als Produktions-Backup betrachtest.

Ein vollständiger Backup-Plan umfasst:

• den konfigurierten HITKEEP_DB_PATH;
• den gesamten HITKEEP_DATA_PATH, einschließlich tenants/*/hitkeep.db;
• die konfigurierten Archiv- und Backup-Pfade;
• alle externen S3-Objekte, wenn diese Pfade s3://-URLs verwenden.

Unter Backups und Wiederherstellung findest du Wiederherstellungsverfahren, unter S3-Backups die Ablage außerhalb des Rechners.

Hinweise für den Produktivbetrieb

• Schalte HTTPS vor HitKeep und setze HITKEEP_PUBLIC_URL auf die exakte, im Browser sichtbare URL.
• Konfiguriere vertrauenswürdige Proxys, wenn der Datenverkehr über einen Reverse Proxy oder Load Balancer läuft.
• Betreibe HitKeep über einen macOS-Dienstmanager, wenn es automatisch starten soll. Halte Geheimnisse aus dem Shell-Verlauf und aus Dienstargumenten heraus.
• Verwende für systemd-basierte Server die Anleitung zur Linux-Binärdatei.