HitKeep Self-Hosted Web Analytics installieren

HitKeep ist selbst gehostete Webanalyse in einer einzigen Go-Binärdatei mit eingebettetem DuckDB und NSQ. Wähle unten den Installationsweg passend zu dem System, das du bereits betreibst. Eine separate Instanz von PostgreSQL, Redis, ClickHouse, Kafka oder eines Queue-Dienstes ist nicht erforderlich.

Wenn du dasselbe Produkt nutzen möchtest, ohne selbst Upgrades und Backups zu betreiben, vergleiche stattdessen HitKeep Cloud.

Installationsmethode auswählen

HomebrewDer kürzeste Installations- und Upgrade-Weg auf Apple-Silicon-Macs oder x86_64-Linux über den offiziellen Tap.

Linux-BinärdateiBetreibe HitKeep als einen Prozess auf einem VPS, einer VM, einem Bare-Metal-Server, Raspberry Pi oder in einem eingeschränkten Netzwerk.

Docker ComposeNutze eine reproduzierbare Container-Bereitstellung mit persistenten Volumes für Daten, Archive und Backups.

Kubernetes und HelmInstalliere den offiziellen OCI-Helm-Chart in einem Cluster, den du bereits betreibst.

Deine Umgebung	Einstieg	Was du betreibst
Apple-Silicon-Mac oder x86_64-Linux	Homebrew	Eine lokale Binärdatei und ihr Datenverzeichnis
Linux-VPS, VM, Bare Metal, ARM64 oder eingeschränktes Netzwerk	Linux-Binärdatei	Einen systemd-Dienst und sein Datenverzeichnis
Docker-basierter Host	Docker Compose	Einen Container und drei persistente Volumes
Bestehende Kubernetes-Plattform	Kubernetes und Helm	StatefulSet, PVC, Service und optionalen Ingress

Du nutzt einen Reverse Proxy?

Konfiguriere vertrauenswürdige Proxys, bevor du Produktionsverkehr über Caddy, nginx, Traefik, einen Ingress-Controller oder Load Balancer leitest. So bleiben Client-IPs, Geometadaten, Ausschlüsse und Ratenbegrenzungen korrekt.

Was jede Produktionsinstallation benötigt

1. Lege die im Browser sichtbare HITKEEP_PUBLIC_URL fest.
2. Erzeuge einen starken HITKEEP_JWT_SECRET und speichere ihn dauerhaft.
3. Lege Datenbank, Mandantendaten, Archive und Backups auf persistentem Speicher ab.
4. Schalte HTTPS vor HitKeep und konfiguriere vertrauenswürdige Proxys.
5. Prüfe /healthz und /readyz und schließe anschließend den Einrichtungsassistenten ab.
6. Teste Backup und Wiederherstellung, bevor du dich auf die Bereitstellung verlässt.

Die Konfigurationsreferenz enthält die aktuellen Flags, Umgebungsvariablen, Standardwerte und Hinweise zu sensiblen Werten. Backups und Wiederherstellung erklärt den vollständigen Datensatz und den Wiederherstellungsablauf.

Nach der Installation

Öffne deine konfigurierte öffentliche URL. Der Einrichtungsassistent erstellt den ersten Besitzer und führt dich durch das Hinzufügen einer Website und die Installation des Tracking-Snippets.

Als Nächstes:

• Tracking verstehen und prüfen
• Vertrauenswürdige Proxys konfigurieren
• Backups und Wiederherstellung planen
• Leistung und Speicherverbrauch optimieren