Self-Hosting

Der Chastity Tracker ist auf den Betrieb auf eigener Hardware ausgelegt. Als Docker-Container läuft die Anwendung mit eigener Datenbank auf dem eigenen Server, optional erweitert um lokale KI und eine Hardware-Schlüsselbox. Alle Daten bleiben dabei unter eigener Kontrolle.

Self-Hosting mit Docker

Die Anwendung wird als Docker-Container über ein veröffentlichtes Image bereitgestellt und auf dem eigenen Server betrieben. Die Daten liegen in einer eigenen SQLite-Datenbank im Container-Verzeichnis.

Konfiguration und Umgebungsvariablen passen die Instanz an die eigene Umgebung an, Updates erfolgen über neue Image-Versionen.

Lokale KI

Voreingestellt ist die Foto-Prüfung aus. Als Admin schaltest du sie in der App ein: mit eigenem API-Schlüssel für einen externen Anbieter, dann gehen die Fotos dorthin, oder mit einem lokalen Modell über Ollama auf eigener Hardware; dann verlässt kein Foto den eigenen Server, auch nicht bei einem Ausfall. Der bisherige Weg über Umgebungsvariablen funktioniert weiterhin, eine Einstellung in der App hat Vorrang.

Dazu kommt optional ein CLIP-Dienst: er gleicht Fotos gegen hinterlegte Referenzbilder ab und beschleunigt die Geräteerkennung. Fällt er aus, übernimmt das Bildmodell — wo das Foto dann ausgewertet wird, entscheidet dessen Einstellung.

KI-Keyholder über MCP

Über das MCP-Protokoll kann ein KI-Assistent als Keyholder agieren. Er liest den aktuellen Stand und vergibt Direktiven im Rahmen menschlich gesetzter Freitext-Regeln.

Die Regeln bleiben jederzeit in menschlicher Hand, und jede Aktion der KI wird vollständig auditiert. So lässt sich automatisierte Kontrolle mit nachvollziehbaren Grenzen kombinieren. Freigeschaltet wird die Schnittstelle pro Instanz über zwei Umgebungsvariablen: ENABLE_MCP schaltet sie ein, MCP_USERNAME bestimmt, wessen Daten der KI-Keyholder liest und steuert. Ein Server steuert genau einen Sub; die vollständigen Schritte stehen in der Dokumentation im Repository.

Telegram-Benachrichtigungen

Optional kommt Telegram als dritter Benachrichtigungs-Kanal neben E-Mail und Push dazu. Pro Instanz gibt es einen Bot, den du als Betreiber bei @BotFather anlegst; Token und Bot-Name trägst du über die Umgebungsvariablen TELEGRAM_BOT_TOKEN, TELEGRAM_BOT_USERNAME und TELEGRAM_WEBHOOK_SECRET ein und registrierst danach den Webhook einmalig. Ohne Token und Bot-Namen ist der Telegram-Abschnitt in den Einstellungen unsichtbar, und es wird nichts gesendet.

Der Meldungstext läuft über die Server von Telegram, einem Drittanbieter, und ein Bot-Chat ist nicht Ende-zu-Ende-verschlüsselt. Beim Self-Hosting richtest du den Bot selbst ein; das Portal tut das nicht automatisch. Die Schritte stehen in der Docker-Anleitung im Blog.

Gewichtstracking

Ab Tracker-Version 6.2.7 ist das Gewichtstracking auf jeder Instanz verfügbar, ohne Umgebungsvariable. Die frühere Variable ENABLE_WEIGHT_TRACKING entfällt und kann aus der .env gestrichen werden.

Voreingestellt bleibt es je Sub aus: erst der Keyholder schaltet es beim Sub in den Einstellungen ein, vorher erscheint nichts davon. Gewicht und Körpergrösse liegen in der SQLite-Datenbank der Instanz, die Waagen-Fotos in ihrem Upload-Verzeichnis — wie die übrigen Daten und Fotos. Die Fotos werden voreingestellt nach 60 Tagen gelöscht, der Wert bleibt; die Frist stellst du mit WEIGHT_PHOTO_RETENTION_DAYS ein (0 = nicht löschen). Ist die Foto-Prüfung eingeschaltet, geht das Waagen-Foto zum Lesen an den dort gewählten Dienst.

LockMeBox-Schlüsselbox

Die LockMeBox von kinkystuffmade.com lässt sich direkt mit dem Tracker steuern, über Bluetooth und mit dem Handy als Relais.

Eine selbst gehostete Instanz braucht dafür einen Schlüssel in der Konfiguration. Das Projekt stellt ihn nicht bereit: Die LockMeBox funktioniert beim Self-Hosting nur, wenn du den passenden Schlüssel selbst hast. Der Chastity Tracker ist ein eigenständiges Hobby-Projekt; der Hersteller der Box ist daran nicht beteiligt. Fragen zum Tracker gehen an uns, nicht an den Hersteller der Box.

Apps für selbst gehostete Instanzen

Auf dem Handy nutzt du als Self-Hoster die installierbare Web-App (PWA) deiner eigenen Instanz: auf Android über „App installieren“ im Chrome-Menü, auf iPhone und iPad über „Teilen“ → „Zum Home-Bildschirm“ in Safari. Sie empfängt Web-Push, ohne dass du dafür einen Schlüssel von uns brauchst.

Die nativen Apps für Android und iOS gibt es nur für Portal-Instanzen. Sie nehmen keine selbst gehosteten Adressen an, und Push über die App braucht die privaten Push-Schlüssel des Projekts, die nicht weitergegeben werden. Das ist eine bewusste Grenze, kein Fehler deiner Installation.

Quellcode auf GitHub

Code, Setup-Anleitung und Container-Image sind öffentlich verfügbar. Dort finden sich die Schritte für den Betrieb auf eigener Hardware.

Auf GitHub ansehen