HitKeep - Open-Source Web Analytics zum selbst hosten

Finde ich grundsätzlich interessant (ohne mich gerade eingehend über die "Tracker" Technologie informiert zu haben) und werde es mir mal anschauen. Ich arbeite aktuell noch mit dem Aufruf einer .php Datei die die Daten der Besucher vor der Verarbeitung anonymisiert und erst dann an Google Analytics schickt (rechtlich geprüft und als DSGVO Konform bestätigt).

Quote from Examo

[...] keine genaueren Kohortendaten etc. mit wiederkehrenden Nutzern [...]

Und genau das ist ja ohne aktive Zustimmung gerade nicht mehr zulässig (will ich auf meiner Homepage auch nicht haben) und daher geht es (ohne Zustimmung) nur, wenn es vor der Verarbeitung (gerade an Google Analytics) anonymisiert wird, d.h. insbesondere die IP Adresse.

Wie ist Dein Projekt grundsätzlich gedacht, mit Zustimmungsbanner oder ohne? Das macht ja gerade den entscheidenden Unterschied. Ich nutze aktuell das hier: https://www.analytics-ohne-einwilligung.de

Quote from Examo

[...] IP-Adressen der Nutzer werden auch entsprechend der aktuellsten EU-Richtlinien überhaupt nicht gespeichert, sondern nur für Spam-Erkennung genutzt. [...]

Und damit werden Sie ja verarbeitet (Klugscheißermodus aus) aber ja gerade auf dem eigenen Server und danach ja wahrscheinlich nicht mehr (wegen fehlender IP Speicherung) zurückverfolgbar (anonymisiert). Aber ich finde das Projekt auf den ersten Blick echt gut, Matomo ist mir zu überladen und daher habe ich bislang den oben erwähnten Ansatz über GA.

Hallo! Bevor ich es in meinem Docker installiert hätte, wollte ich einfach mal die kostenlose gehostete Version ausprobieren.

Gefällt mir sehr gut und ist auch schön übersichtlich.

Jedoch ist mir eines aufgefallen (und darum habe ich es noch nicht selbst installiert):
Man kann ein Team einrichten und jemanden eine Einladung schicken. Mail kommt dort auch an mit einem Link. Dieser Link führt jedoch zum Login-Fenster, wobei der Eingeladene ja noch keine Zugangsdaten hat. Er kann sich stattdessen nur einen eigenen EU oder US-Bereich einrichten.
Vielleicht übersehe ich auch nur was dabei.

Nächster Schritt ist dann selfhost..

Da bei mir die Migration von Matomo auf einen neuen Server anstand, und ich 95% der Matomo-Features eh nie benutzt habe, habe ich stattdessen HitKeep eingerichtet und mit den Wordpress-Seiten verbunden (Parallelbetrieb).

Funktioniert soweit ohne Probleme. Vielen Dank, Examo!

Version hochzählen und Ansible laufen lassen.

Die neue Übersichtsseite ist sehr praktisch!

Ich nutze Hitkeep jetzt bereits seit ein paar Monaten privat und finde den Zufall, nun plötzlich hier im netcup Forum davon zu lesen umso cooler. Ich muss sagen, ich bin absolut begeistert. Zwar kann ich aufgrund der Entscheidung, server-seitiges Tracking (statt des JavaScript Snippets) zu verwenden, nicht alle Features vollumfänglich nutzen, bin aber trotzdem super happy – anders als bei einigen anderen Tools (*hust* Matomo *hust*) ist die UI total intuitiv und die Tatsache, dass sich Hitkeep sehr leichtgewichtig als einzelner Container oder einzelne Binary deployen lässt (und nicht noch ein ClickHouse, Redis und sonsige zusätzliche Services benötigt) gefällt mir. Danke für das Projekt

Schaut auf den ersten Blick wirklich gut aus!

Ich werde mich demnächst mal mehr damit beschäftigen. Danke für dieses Projekt und deine Arbeit!

Vielen Dank für das Projekt würde es gerne auf privaten Webseiten einsetzen und habe heute dem VPS 200 G8 mal eine docker-compose.yml Datei spendiert und wollte einfaches Selbsthosting probieren. Bevor ich also das etwas komplexere Caddy On-Demand SSL und Reverse Proxy Setup starte die minimale aufgesetzt und folgende Einträge konfiguriert für die letzte HitKeep Version 2.10.0 direkt anhand der README auf der GitHub Seite: https://github.com/PascaleBeier/hitkeep

docker-compose.yml

Quote

Code

services:
  hitkeep:
    image: pascalebeier/hitkeep:latest #latest 2026-07-07 war 2.10.0
    container_name: hitkeep #habe ich ergänzt
    env_file: .env #zum einlesen der .env Datei (siehe unten)
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - hitkeep_data:/var/lib/hitkeep/data
    environment:
      HITKEEP_JWT_SECRET: replace-this-with-a-long-random-string #hier steht ein langer Zufallsstring ;-)
    command:
      - "-public-url=http://localhost:8080"

volumes:
  hitkeep_data: {}

Display More

Und die .env Datei dann vor befüllt mit ein paar netcup relevanten Mail Einstellungen, da ich dachte den Fehler so bereinigen zu können:
Denke ich in die falsche Richtung oder ist es nicht das E-Mail-Setup, dass hier den Fehler produziert?

.env

Quote

HITKEEP_MAIL_HOST=mx1a2b.netcup.net
HITKEEP_MAIL_PORT=587
HITKEEP_MAIL_USERNAME=user@domain.tld
HITKEEP_MAIL_PASSWORD=mypass
HITKEEP_MAIL_ENCRYPTION=tls
HITKEEP_MAIL_FROM_ADDRESS=hitkeep@localhost
HITKEEP_MAIL_FROM_NAME=HitKeep

Display More

Beim Erstellen des Admin Kontos dann folgende Fehlermeldung auf der Weboberfläche (nicht per http://localhost:8080 aufgerufen) und keine Fehler im Log des Docker Containers:

Ein unerwarteter Fehler ist aufgetreten. Bitte versuche es erneut.

Das mit dem command in deiner docker-compose.yml sieht etwas komisch aus. Warum nutzt du nicht einfach die entsprechende Umgebungsvariable?

HITKEEP_PUBLIC_URL=http://localhost:8080

Und laut der Binary Doku müsste das public-url Argument ein -- statt einem einfachen Bindestrich haben, falls du es doch so setzen willst, was ich nicht unbedingt empfehlen würde, wenn es man es auch über den env steuern kann.

Ehm. einfach https://github.com/PascaleBeier/h…in/compose.yaml verwenden statt selbst was stricken?

Als Frage an Examo : wieso haben alle ENVs einen Doppelpunkt und nicht das etabliertere "="?

Und für die Arbeit und das Angebot hier!

Habe es gestern als Docker Container auf meinem ARM Server installiert, ging eigentlich recht fix, mit ein paar Problemen bei der Installation.

Ich habe mich nach dieser Seite gehalten, musste jedoch etwas abwandeln
https://hitkeep.com/guides/installation/docker-compose/

compose.yml - hier habe ich nur die Hitkeep Public URL (Zeile14) auf meine tatsächliche Domain aus NGINX ausgebessert

services:
  hitkeep:
    image: pascalebeier/hitkeep:latest
    container_name: hitkeep
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - hitkeep_data:/var/lib/hitkeep/data
      - hitkeep_archive:/var/lib/hitkeep/archive
      - hitkeep_backups:/var/lib/hitkeep/backups
    environment:
      # Public URL must match the browser-visible origin, including any path prefix.
      HITKEEP_PUBLIC_URL: ${HITKEEP_PUBLIC_URL:-http://localhost:8080}
      # Required for stable sessions. Generate with: openssl rand -hex 32
      HITKEEP_JWT_SECRET: ${HITKEEP_JWT_SECRET:?set HITKEEP_JWT_SECRET in .env}
      # Keep live data, retention archives, and backup snapshots on persistent volumes.
      HITKEEP_DB_PATH: /var/lib/hitkeep/data/hitkeep.db
      HITKEEP_DATA_PATH: /var/lib/hitkeep/data
      HITKEEP_ARCHIVE_PATH: /var/lib/hitkeep/archive
      HITKEEP_BACKUP_PATH: /var/lib/hitkeep/backups
      HITKEEP_BACKUP_INTERVAL: ${HITKEEP_BACKUP_INTERVAL:-60}
      HITKEEP_BACKUP_RETENTION: ${HITKEEP_BACKUP_RETENTION:-24}
      # Optional OSS spam-list refresh. Disable for fully offline/air-gapped installs.
      HITKEEP_SPAM_FILTER_AUTO_UPDATE: "true"
      HITKEEP_SPAM_FILTER_UPDATE_INTERVAL: ${HITKEEP_SPAM_FILTER_UPDATE_INTERVAL:-1440}
      HITKEEP_SPAM_FILTER_PATH: /var/lib/hitkeep/data/spam-filter.json
      # Optional read-only MCP endpoint for governed assistant/reporting access.
      HITKEEP_MCP_ENABLED: "true"
      HITKEEP_MCP_PATH: /mcp
      HITKEEP_MCP_MAX_RANGE_DAYS: ${HITKEEP_MCP_MAX_RANGE_DAYS:-366}
      # Optional AI model route for Opportunity enrichment. Provider credentials
      # use the selected goAI provider's own env vars, such as OPENAI_API_KEY.
      HITKEEP_AI_ENABLED: ${HITKEEP_AI_ENABLED:-false}
      HITKEEP_AI_PROVIDER: ${HITKEEP_AI_PROVIDER:-}
      HITKEEP_AI_MODEL: ${HITKEEP_AI_MODEL:-}
      HITKEEP_AI_BASE_URL: ${HITKEEP_AI_BASE_URL:-}
      HITKEEP_AI_REGION: ${HITKEEP_AI_REGION:-}
      HITKEEP_AI_API_KEY: ${HITKEEP_AI_API_KEY:-}
      HITKEEP_AI_REQUEST_LIMIT: ${HITKEEP_AI_REQUEST_LIMIT:-100}
      HITKEEP_AI_TOKEN_LIMIT: ${HITKEEP_AI_TOKEN_LIMIT:-100000}
      HITKEEP_AI_BUDGET_WINDOW: ${HITKEEP_AI_BUDGET_WINDOW:-1440}
      # Optional Google Search Console OAuth integration.
      HITKEEP_GOOGLE_SEARCH_CONSOLE_CLIENT_ID: ${HITKEEP_GOOGLE_SEARCH_CONSOLE_CLIENT_ID:-}
      HITKEEP_GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET: ${HITKEEP_GOOGLE_SEARCH_CONSOLE_CLIENT_SECRET:-}
      HITKEEP_GOOGLE_SEARCH_CONSOLE_REDIRECT_URL: ${HITKEEP_GOOGLE_SEARCH_CONSOLE_REDIRECT_URL:-}
      # SMTP powers invites, password reset, email reports, and security mail.
      HITKEEP_MAIL_HOST: ${HITKEEP_MAIL_HOST:-}
      HITKEEP_MAIL_PORT: ${HITKEEP_MAIL_PORT:-587}
      HITKEEP_MAIL_USERNAME: ${HITKEEP_MAIL_USERNAME:-}
      HITKEEP_MAIL_PASSWORD: ${HITKEEP_MAIL_PASSWORD:-}
      HITKEEP_MAIL_ENCRYPTION: ${HITKEEP_MAIL_ENCRYPTION:-tls}
      HITKEEP_MAIL_FROM_ADDRESS: ${HITKEEP_MAIL_FROM_ADDRESS:-hitkeep@localhost}
      HITKEEP_MAIL_FROM_NAME: ${HITKEEP_MAIL_FROM_NAME:-HitKeep}

volumes:
  hitkeep_data: {}
  hitkeep_archive: {}
  hitkeep_backups: {}

bei der .env Datei hatte ich einige Probleme
Die sollte lt Seite so ausschauen

{
  echo "HITKEEP_JWT_SECRET=$(openssl rand -hex 32)"
  echo "HITKEEP_PUBLIC_URL=http://localhost:8080"
  echo "HITKEEP_MAIL_HOST="
  echo "HITKEEP_MAIL_PORT=587"
  echo "HITKEEP_MAIL_USERNAME="
  echo "HITKEEP_MAIL_PASSWORD="
  echo "HITKEEP_MAIL_FROM_ADDRESS=hitkeep@localhost"
  echo "HITKEEP_MAIL_FROM_NAME=HitKeep"
} > .env

Debian meckerte aber, dass die .env keine geschwungene Klammern haben darf, dann bemeckerte er auch das "openssl rand -hex32" (habe ich dann direkt eingefügt) und ebenso die ganzen Echo Ausdrücke

meine schaut jetzt so aus (natürlich zensiert)

HITKEEP_JWT_SECRET="hierkommtirgendwasrein"
HITKEEP_PUBLIC_URL="gleiche Domain wie in der compose.yml"
HITKEEP_MAIL_HOST="smtp.xxxxx.com"
HITKEEP_MAIL_PORT="587"
HITKEEP_MAIL_USERNAME="benutzername"
HITKEEP_MAIL_PASSWORD="passwort"
HITKEEP_MAIL_FROM_ADDRESS="name@domain.com"
HITKEEP_MAIL_FROM_NAME="Absendername"

Dann konnte man den Docker Container ganz normal hochfahren und es läuft auch perfekt

docker compose up -d
docker compose logs -f hitkeep

Hoffe das hilft dir

Nachträglich hatte ich wahrscheinlich einiges falsch verstanden bei der .env
OpenSSL hatte ich nicht installiert, darum wahrscheinlich ein Fehler und die Anleitung mit "create a .env file" war wahrscheinlich nicht gemeint, dass man die Datei selbst händisch erstellt und befüllt sondern den Befehl so wie auf der Seite direkt am Terminal absetzt mit den korrekten Daten. Darum die echo Befehle, die Frage ist nur, warum sollte man das tun