---
title: "HitKeep mit Homebrew auf macOS und Linux installieren | HitKeep"
description: "Installiere, prüfe, aktualisiere und sichere HitKeep auf macOS ARM64 oder Ubuntu Linux AMD64 und ARM64 mit dem offiziellen Homebrew-Tap."
canonical: "https://hitkeep.com/de/guides/installation/homebrew/"
---

# 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](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](https://hitkeep.com/reference/configuration/) 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](https://github.com/PascaleBeier/hitkeep/releases/latest), 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](https://hitkeep.com/guides/data/backups-and-restore/) findest du Wiederherstellungsverfahren, unter [S3-Backups](https://hitkeep.com/guides/data/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](https://hitkeep.com/guides/installation/trusted-proxies/), 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](https://hitkeep.com/de/guides/installation/binary/).

[Vorherige Seite Übersicht](https://hitkeep.com/de/guides/installation/)[Nächste Seite Linux-Binärdatei](https://hitkeep.com/de/guides/installation/binary/)