Git-Timestamps selbst hosten mit Docker Compose
Manuelles Timestamping scheitert jedes Mal auf dieselbe Weise. Jemand schreibt ein Runbook, jemand anderes macht ein Skript daraus, das Skript läuft drei Wochen, eine Festplatte läuft voll oder ein Token läuft ab, und niemand merkt es – bis zu dem Tag, an dem ein Anwalt einen Nachweis dafür verlangt, dass Ihr Repository vor achtzehn Monaten einen bestimmten Zustand hatte.
Das Anchoring selbst ist nicht der schwierige Teil. Schwierig ist die Pipeline drumherum: Commits erkennen, Hashes bündeln, Neustarts überstehen, Belege ausliefern und das Ganze Jahre später noch verifizierbar halten. Genau das liefert Ihnen ein selbst gehosteter Compose-Stack – ein reproduzierbares, nachvollziehbares Deployment, bei dem die Automatisierung in Ihrem Netzwerk läuft und Sie das Datenverzeichnis besitzen.
Dieser Artikel zeigt, wie Sie Timestamp GIT on-premises mit Docker Compose deployen, einmal eine GitHub App verbinden und dann einen automatisierten nächtlichen Worker Ihre Commit-Hashes in Bitcoin verankern lassen. Wenn Sie zuerst den konzeptionellen Hintergrund möchten, lesen Sie Cryptographic Prior Art: The Startup Shield Against Patent Trolls.
Warum Git-Timestamps selbst hosten?
Einen Timestamping-Schritt von Hand auszuführen bedeutet, sich pro Repository an drei Pflichten zu erinnern: die Commit-Hashes stempeln lassen, die entstandenen Proof-Dateien einsammeln und sie irgendwo dauerhaft und prüfbar speichern. Verpassen Sie eine davon, hat die Kette Lücken; verpassen Sie den Speicherschritt, haben Sie Belege, die niemand findet.
Self-Hosting adressiert eine andere Klasse von Anforderungen:
- Datenresidenz. Compliance-Teams wollen wissen, wo Commit-Metadaten verarbeitet werden. Beim Docker-Image lautet die Antwort: „auf unserem Host“.
- Eingeschränkte Netzwerke. Manche Teams gewähren keiner SaaS-Lösung Lesezugriff auf Quell-Repositories – selbst nicht read-only –, unabhängig davon, was ein Anbieter verspricht.
- Deployments nahe am Air-Gap. Sie können das Image auf einem internen Host betreiben; nur der Anchoring-Schritt benötigt ausgehenden Zugriff auf öffentliche OpenTimestamps-Kalender.
- Operative Kontrolle. Sie entscheiden über Update-Kadenz, Backup-Zeitplan und darüber, wer den Setup-Assistenten erreichen kann.
Docker Compose passt gut, weil das gesamte System aus zwei Containern besteht: der Anwendung und einer Valkey-Instanz, die als In-Memory-Hash-Queue dient. Ein pull und ein up -d liefern eine laufende Instanz; das ./data-Volume erhält den Zustand über Neustarts hinweg; das Update ist docker compose pull && docker compose up -d.
Entscheidend ist: Das Docker-Image ist dieselbe Automatisierung wie das gehostete Produkt – GitHub-App-gesteuerte Commit-Erkennung, nächtliches Bitcoin-Anchoring, .ots-Belege, die zurück in Ihr Repository gepusht werden –, nur eben auf Ihrer Infrastruktur.
Einmalige Einrichtung: Docker Compose und GitHub App
Voraussetzungen
- Docker Engine mit dem Compose-Plugin.
- Ein Host mit zuverlässiger Verfügbarkeit und ausgehendem Internetzugriff (erforderlich für Bitcoin-Anchoring über öffentliche OpenTimestamps-Kalender).
- Eine GitHub App, die Sie auf den Ziel-Repositories installieren können, und ein Ziel-Repository (oder Shadow-Repository), in das Proof-Branches geschrieben werden können.
- Eine Lizenzdatei für die Instanz.
Die Compose-Datei
Ein Quick-Start-Docker-Compose-Setup sieht so aus:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
Zwei Dinge sollten Sie beachten, bevor Sie weitermachen. Der Bind-Mount ./data:/app/data ist der dauerhafte Zustand der Instanz – behandeln Sie ihn als kritische Daten, nicht als Cache. Und restart: unless-stopped ist hier wichtiger als sonst üblich: Der Mitternachts-Worker muss um Mitternacht laufen.
Starten Sie den Stack:
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
Die Anwendung ist nach dem Start unter http://localhost:8080 erreichbar.
Erster Start
Beim ersten Start führt Sie ein Setup-Assistent durch die Verbindung Ihrer GitHub App und die Konfiguration Ihrer Instanz. Planen Sie die Berechtigungen, bevor Sie sich durchklicken:
- Standard Mode. Die GitHub App liest nur den HEAD-Commit-Hash jedes überwachten Repositories und schreibt Proofs in ein Ziel-Repository. Das Berechtigungsmodell von GitHub erfordert mindestens Lesezugriff auf das Quell-Repository sowie Lese-/Schreibzugriff auf das Ziel.
- Enterprise ZK Mode. Eine 12-zeilige GitHub Action läuft auf Ihrer Infrastruktur und pusht nur den Commit-Hash an die API. Sie benötigen Lese-/Schreibzugriff auf das Ziel-Repository und keinen Lesezugriff auf die Quelle.
Wenn Sie dies 2026 für ein Team evaluieren, das sich bereits auf den gehosteten GitHub-App-Workflow festgelegt hat, werden Ihnen die Einrichtungsschritte vertraut vorkommen – siehe Automate Git Commit Timestamping With a GitHub App für diesen Weg.
Lizenzierung
Eine zeitlich begrenzte Demo-Lizenz zur Evaluierung erhalten Sie, indem Sie das Anfrageformular auf der Docker-License-Seite mit Ihrem Namen, Unternehmen, E-Mail und optionaler Telefonnummer absenden. Sie können eine zeitlich begrenzte Demo-Lizenzdatei herunterladen und während des Enterprise-Setups hochladen.
Wenn die Instanz von irgendwo außer localhost erreichbar ist, stellen Sie sie hinter einen TLS-terminierenden Reverse-Proxy und beschränken Sie den Zugriff auf Netzwerkebene. Der Setup-Assistent ist eine administrative Oberfläche.
Die automatisierte Pipeline: Vom Commit zum Bitcoin-Proof
Sobald die GitHub App verbunden ist, läuft die Pipeline von selbst:
- Commit-Erkennung. Die GitHub App empfängt Webhooks für neue Commits, oder – im Enterprise ZK Mode – Ihre GitHub Action pusht Commit-Hashes an die API.
- Hash-Queue. Commit-Hashes landen in Valkey, dem In-Memory-Key-Value-Store, der für das Batching verwendet wird.
- Mitternachts-Cron-Worker. Jede Nacht gruppiert der Worker alle ausstehenden Hashes, schreibt ein Manifest
.txtpro Repository, baut einen Merkle-Baum, erstellt OpenTimestamps-Proofs über öffentliche OTS-Kalender und verankert die Merkle-Wurzel in Bitcoin. - Proof-Auslieferung. Das Manifest und die
.ots-Belegdateien werden in einen dedizierten Timestamps-Branch oder ein Shadow-Repository in Ihr Repository zurückgepusht. - Bestätigung. Die Bitcoin-Bestätigung dauert mehrere Stunden – normalerweise etwa drei –, sodass das Schreiben der Proofs einige Stunden nach dem Batch-Lauf abgeschlossen ist.
Die Zero-Knowledge-Eigenschaft ist strukturell bedingt, keine reine Richtlinienaussage: Es werden nur Commit-Hashes verarbeitet. Ob Sie den Standard Mode oder den Enterprise ZK Mode betreiben, Ihr Quellcode verlässt niemals Ihr Netzwerk. Das Docker-Deployment verlagert den Hash-Verarbeitungsschritt einfach ebenfalls innerhalb Ihres Perimeters.
Da die Merkle-Wurzel über OpenTimestamps in einem Bitcoin-Block verankert wird, ist der Timestamp nach der Bestätigung unveränderlich. Keine Instanz kann ihn ändern oder fälschen – weder der Anbieter noch Sie selbst.
Monitoring und Fehlerbehandlung
Eine Timestamping-Pipeline scheitert leise. Commit-Hashes sammeln sich an, nichts meldet einen Fehler, und Sie entdecken die Lücke bei einem Audit. Betrachten Sie Monitoring als Teil des Deployments.
Container- und Queue-Zustand. Die nützlichste Prüfung ist der eigene Status der Anwendung für ein bekanntes Repository. Richten Sie Ihren Uptime-Monitor darauf aus:
#!/usr/bin/env bash
set -euo pipefail
BASE="http://localhost:8080"
USER="acme"
REPO="platform"
docker compose ps --status running --quiet timestampgit >/dev/null \
|| { echo "timestampgit container is not running"; exit 1; }
curl -fsS "$BASE/api/statusLast/$USER/$REPO" | jq .
GET /api/statusLast/{user}/{repo} gibt die Info zum zuletzt verankerten Bitcoin-Block zurück. Wenn dieser Block nicht mehr fortschreitet, hängt der Worker.
Öffentliche Verifikations-Badges. Für jedes überwachte Repository erzeugt das Badge-Widget einbettbares Shields.io-Markdown für Ihre README. Der Snippet wird von GET /api/badgeLink/{user}/{repo} (authentifiziert) ausgeliefert und sieht ungefähr so aus:
[](https://timestampgit.dev/status/acme/platform)
Jeder kann dem Link folgen, um den Timestamp über die Website zu verifizieren. Bei privaten Repositories trägt die Status-URL einen verschlüsselten HMAC speziell für Ihre Serverinstanz, sodass nur autorisierte Benutzer den Status lesen können.
Audit und Reports. Rufen Sie das Ledger nach Zeitplan ab statt auf Anfrage:
curl -fsS -o audit-$(date +%F).csv "$BASE/api/audit/$USER/$REPO"
curl -fsS -o report-$(date -d yesterday +%F).pdf \
"$BASE/api/report/$USER/$REPO/$(date -d yesterday +%F)"
Das liefert Ihnen ein CSV-Audit-Ledger und ein datumsbezogenes PDF-Zertifikat, das Rechts- und Compliance-Teams ablegen können, ohne selbst die API anzufassen.
Verzögerungen bei der Bestätigung. Das Anchoring ist normalerweise nach etwa drei Stunden abgeschlossen. Verzögerungen kommen vor; der Worker versucht es erneut und liefert den .ots-Proof aus, sobald der Anchor bestätigt ist. Alarmieren Sie auf „Manifest geschrieben, aber nach 24 Stunden kein Beleg“ statt auf kurze Verzögerungen – sonst wecken Sie sich wegen normaler Bitcoin-Block-Schwankungen selbst.
Backup und Restore. Sichern Sie ./data nach Zeitplan, und binden Sie ein benanntes Volume für das /data-Verzeichnis von Valkey ein, wenn eingereihte Hashes eine Neuerstellung des Containers überstehen sollen. Valkey ist per Design ein In-Memory-Store – ihn zu verlieren kostet Sie den Batch einer Nacht, nicht Ihre bestehenden Proofs, denn ausgelieferte Proofs liegen im Timestamps-Branch.
Best Practices für selbst gehostetes Timestamping
- Widmen Sie einen Host. Der Worker läuft um Mitternacht und braucht stabile Verfügbarkeit und ausgehende Konnektivität. Einen Host mit einer lauten Build-Farm zu teilen, provoziert einen verpassten Batch.
- Halten Sie das Daten-Volume aus flüchtigem Speicher heraus. Binden Sie
./dataan dauerhaften Speicher und nehmen Sie es in Ihre Backup-Rotation auf. - Beschränken Sie die Admin-Oberfläche. Stellen Sie den Assistenten und die authentifizierte API hinter Ihr VPN oder einen Reverse-Proxy mit starker Authentifizierung. Setzen Sie Port 8080 nicht dem öffentlichen Internet aus.
- Aktualisieren Sie bewusst. Führen Sie
docker compose pullnach einem von Ihnen kontrollierten Zeitplan aus; lesen Sie das Changelog, bevor Sie ein neues:prod-Image ziehen. - Bevorzugen Sie den Enterprise ZK Mode, wenn Berechtigungen umstritten sind. Wenn Ihr Sicherheitsteam keinen Lesezugriff auf Quell-Repositories gewährt, erfüllt der GitHub-Action-Weg diese Anforderung, ohne die Automatisierung zu ändern.
- Dokumentieren Sie den Prozess für Auditoren. Halten Sie fest, wo die Instanz läuft, wer sie administriert, wie Backups verifiziert werden und wo
.ots-Belege gespeichert sind. Der Proof ist kryptografisch; die Beweiskette braucht trotzdem einen Absatz. - Testen Sie eine Verifikation von Anfang bis Ende. Wählen Sie ein verankertes Datum und gehen Sie den Verifikationsablauf durch, bevor Sie ihn in einem Streitfall brauchen – nicht währenddessen. Zur rechtlichen Einordnung siehe Is a Bitcoin Timestamp Admissible as Evidence? A Compliance Guide.
FAQ
Muss ich meinen Quellcode für Timestamp GIT offenlegen? Nein. Timestamp GIT verarbeitet nur Commit-Hashes. Im Standard Mode liest die GitHub App den HEAD-Commit-Hash; im Enterprise ZK Mode pusht eine GitHub Action nur den Hash von Ihrer Infrastruktur. Ihr Quellcode verlässt niemals Ihr Netzwerk.
Was passiert, wenn die Bitcoin-Bestätigung länger dauert als erwartet?
Der Mitternachts-Cron-Worker verankert die Merkle-Wurzel über OpenTimestamps in Bitcoin. Die Bestätigung dauert typischerweise etwa 3 Stunden. Verzögert sich die Bestätigung, versucht der Worker es erneut und liefert den .ots-Proof nach der Bestätigung aus.
Kann ich das in einer Air-Gap-Umgebung verwenden? Ja, das Docker-Image kann in einer Air-Gap-Umgebung laufen, aber für das Bitcoin-Anchoring über öffentliche OpenTimestamps-Kalender ist ausgehender Internetzugriff erforderlich. Sie können den Netzwerkzugriff entsprechend konfigurieren.
Wie verifiziere ich einen Timestamp unabhängig?
Sie können die .ots-Datei herunterladen und mit Standard-OpenTimestamps-Verifikationstools gegen die Bitcoin-Blockchain prüfen. Alternativ nutzen Sie die Verifikationsseite von Timestamp GIT, die die Verifikation lokal in Ihrem Browser durchführt – niemand sieht, was Sie verifizieren.
Fazit
Beim Selbst-Hosten von Git-Timestamping geht es nicht um Misstrauen gegenüber einem Anbieter; es geht darum, eine automatisierte, prüfbare Pipeline innerhalb einer Grenze zu betreiben, die Ihr Compliance-Team bereits akzeptiert. Zwei Container, eine Lizenzdatei, eine GitHub App – und danach erledigt der Mitternachts-Worker den repetitiven Teil, während Sie ein Repository voller .ots-Belege und eine öffentliche Statusseite erhalten.
Fordern Sie zunächst eine Demo-Lizenz auf der Docker License page an, bringen Sie den Compose-Stack auf einem Staging-Host hoch und verifizieren Sie einen verankerten Tag von Anfang bis Ende. Wenn Sie die Infrastruktur lieber überspringen möchten, bietet Ihnen die verwaltete Timestamp GIT GitHub App dasselbe nächtliche Anchoring ohne Einrichtungsaufwand – und Sie können später auf Self-Hosting migrieren, ohne dass sich ändert, was in Ihrem Repository landet.
Verwandte Beiträge
- Cryptographic Prior Art: The Startup Shield Against Patent Trolls
- Is a Bitcoin Timestamp Admissible as Evidence? A Compliance Guide
- How to Prove You Shipped a Feature Before a Competitor