Timestamp GIT

← Alle Beiträge

2026-11-04

Git-Commits mit Zeitstempeln versehen – ohne Kommandozeile

Git-Commits mit Zeitstempeln versehen – ohne Kommandozeile
timestamp git blockchain proof

Git-Commits ohne Kommandozeile mit Zeitstempeln versehen

Du willst die Eigenschaft, nicht das Verfahren. Die Eigenschaft ist: Dieser Commit-Hash existierte an diesem Datum, und hier ist ein Beleg, den jeder gegen die Bitcoin-Blockchain verifizieren kann. Das Verfahren, das du überspringen willst, besteht darin, auf jedem Entwickler-Laptop Tooling zu installieren, Beweisdateien über Chat-Threads zu jagen und zu hoffen, dass sich zwei Jahre später noch jemand daran erinnert, wie die Verifizierungsseite funktioniert, wenn ein Anwalt danach fragt.

Diese Anleitung zeigt, wie du Git-Commits ohne Kommandozeilen-Tools mit Zeitstempeln versiehst. Alles Folgende spielt sich in einem Browser und in GitHub ab. Du installierst einmal eine GitHub App, richtest sie auf ein Repository aus und committest danach genau wie heute. Timestamp GIT bündelt die Commit-Hashes jede Nacht, verankert sie über das OpenTimestamps-Protokoll in Bitcoin und schreibt die Beweisbelege zurück in dein Repository.

Keine CLI. Kein lokaler Bitcoin-Node. Kein Protokollwissen erforderlich.

Warum die Kommandozeile beim Git-Timestamping überspringen?

Den beschwerlichen Weg gibt es, und du kannst dir vermutlich denken, wie er aussieht: den OpenTimestamps-Client auf deiner Maschine installieren, einen Befehl gegen eine von dir konstruierte Datei ausführen, den resultierenden Beleg irgendwo aufbewahren und das Ganze wiederholen, wann immer du daran denkst. Daraus ergeben sich sofort drei Fehlerquellen:

  • Es ist pro Maschine. Einen neuen Entwickler einzuarbeiten bedeutet, das Ritual erneut zu erklären. Dein CI-Runner braucht es auch. Dein Laptop-Ersatz braucht es wieder.
  • Es ist pro Moment. Zeitstempel decken nur ab, was du zu stempeln gedacht hast. Die Commits, die du vergessen hast — meist die interessanten, die während eines Crunchs entstanden sind —, sind genau die, die du in einem Streitfall brauchen wirst.
  • Es ist fragile Beweislage. Ein Beleg, der im Home-Verzeichnis von irgendjemandem liegt, ohne lückenlose Nachweiskette, ist kein Audit-Trail.

Der verwaltete Weg verlagert all das auf die Serverseite. Timestamp GIT ist eine GitHub App, die deine Repositories beobachtet und Commit-Hashes jede Nacht automatisch verankert. Du berührst das zugrunde liegende Protokoll nie. Der Beweis wird zurück in dein eigenes Repository geschrieben, in einen dedizierten Branch oder ein Shadow-Repo, sodass er mit dem Code lebt, den er beschreibt.

Hintergrund dazu, warum ein einfaches git log von vornherein kein Beweis ist, findest du unter Why Your Git Log Isn’t Proof. Dieser Artikel ist die Anleitung.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

  • Ein GitHub-Konto und ein Repository — öffentlich oder privat —, das du mit einem Zeitstempel versehen willst.
  • Admin-Berechtigungen für dieses Repository oder für die Organisation, der es gehört, damit du eine GitHub App installieren kannst.
  • Für private Repositories einen kostenpflichtigen Plan: Pro Agency (49 $/Monat) oder Enterprise ZK (199 $/Monat). Öffentliche Repositories sind im Open-Source-Plan kostenlos.
  • Sonst nichts. Keine lokale Software, keine OpenTimestamps-Installation, kein Bitcoin-Node, keine Wallet. Ein Browser ist die gesamte Toolchain.

Ein Hinweis zu den Berechtigungen, weil das die Frage ist, die alle zuerst stellen. Das GitHub-Berechtigungsmodell kennt keinen Scope „nur Commit-Hash“, daher erfordert der Standardmodus Lesezugriff auf das Quell-Repository und Lese-/Schreibzugriff auf das Ziel-Repository, in das die Beweise geschrieben werden. Wenn dir selbst Lesezugriff auf die Quelle nicht akzeptabel ist, nutzt der Enterprise-ZK-Modus stattdessen eine GitHub Action und benötigt überhaupt keinen Lesezugriff auf die Quelle. Mehr dazu in Schritt 6.

Schritt für Schritt: Commits ohne Kommandozeile mit Zeitstempeln versehen

Schritt 1: Die Timestamp GIT GitHub App installieren

Installiere die App über den GitHub Marketplace oder von timestampgit.dev. Während der Installation wirst du gefragt, welche Repositories die App sehen darf, und du erteilst die beiden oben beschriebenen Berechtigungssätze: Lesezugriff auf dein Quell-Repo, Lese-/Schreibzugriff auf das Repo, das die Beweisdateien erhält.

Wenn du eine ganze Organisation stempeln willst, installiere einmal auf Organisationsebene statt Repository für Repository.

Schritt 2: Zu überwachende Repositories auswählen

Öffne das Dashboard unter https://timestampgit.dev/repos und wähle aus, welche Repositories überwacht werden. Sobald ein Repository verbunden ist, erkennt die App neue Commits über GitHub-Webhooks — pro Commit ist nichts zu konfigurieren und nichts zu merken.

Du kannst die Verbindung sofort überprüfen. Die öffentlichen Status-Endpunkte liefern JSON, ganz ohne CLI:

# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/your-user/your-repo

# How many commits have been stamped so far
curl -s https://timestampgit.dev/api/statusCount/your-user/your-repo

Ein brandneues Repository liefert legitim Nullwerte, bis der erste nächtliche Lauf abgeschlossen ist.

Schritt 3: Committen wie gewohnt

Das ist der gesamte Schritt „Workflow-Änderung“, und er ist leer. Du schreibst Code, du machst git commit, du pushst. Timestamp GIT erfasst den Commit-Hash, den der Webhook liefert — nicht den Diff, nicht die Dateien, nicht den Quellcode. Der Dienst sieht, kopiert oder speichert deinen eigentlichen Code nie; nur den SHA, der den Repository-Zustand identifiziert.

Praktisch bedeutet das, dass deine Entwickler keine Schulung brauchen und dein Security-Review eine kurze Antwort hat: Die einzigen Daten, die das Repo verlassen, sind ein Hash, und ein Hash ist ein Einweg-Fingerabdruck.

Schritt 4: Den nächtlichen Cron die Verankerung erledigen lassen

Um Mitternacht sammelt ein Worker jeden ausstehenden Commit-Hash ein, gruppiert sie nach Repository und schreibt eine Manifest-Textdatei pro Repo. Er baut einen Merkle-Baum über den Batch, erstellt OpenTimestamps-Beweise gegen öffentliche OTS-Kalender und verankert die Merkle-Wurzel in einer Bitcoin-Transaktion.

Aus diesem Design folgen zwei Dinge:

  • Batching ist günstig und privat. Tausende Commits einzeln zu verankern wäre absurd. Eine Merkle-Wurzel pro Repository pro Tag bedeutet, dass eine Verankerung alles abdeckt, was an diesem Tag committet wurde, und die einzelnen Hashes bleiben im Baum verborgen.
  • Die Beweislieferung ist nicht sofort. Die Manifest- und .ots-Belegdateien werden nach der Bitcoin-Bestätigung in einen dedizierten Timestamps-Branch oder ein Shadow-Repository gepusht, was normalerweise etwa drei Stunden dauert. Ein Lauf, der um Mitternacht startet, ist typischerweise am frühen Morgen fertig.

Commit-Hashes warten bis zum Lauf in einem In-Memory-Key-Value-Store, sodass ein Repository, das einen Tag lang still bleibt, einfach keine neue Beweisdatei erzeugt — keinen Fehler.

Schritt 5: Ein Verifizierungs-Badge einbetten (optional)

Öffne die Seite „Repository Connected“ für dein Repo — https://timestampgit.dev/connected/{user}/{repo} — und verwende das Badge-Widget. Es rendert eine Live-Vorschau und liefert dir einen Markdown-Snippet zum Einfügen in deine README, sodass die Provenienz-Aussage öffentlich und anklickbar ist statt ein Absatz voller Behauptungen.

<!-- Paste the exact snippet generated by the badge widget -->
[![Timestamped with Timestamp GIT](BADGE_URL)](https://timestampgit.dev/status/your-user/your-repo)

Wer auf das Badge klickt, landet auf der öffentlichen Statusseite, und genau dorthin wollen auch Prüfer.

Schritt 6: Self-Hosting oder Zero-Knowledge (optional)

Für Teams mit strengeren Anforderungen gibt es zwei alternative Deployments.

Der Enterprise-ZK-Modus dreht den Datenfluss um: Eine 12-zeilige GitHub Action läuft auf deiner eigenen Infrastruktur und pusht nur den Commit-Hash an die Timestamp-GIT-API. Deine Quelle verlässt nie deine Umgebung, und es ist kein Lesezugriff auf das Quell-Repository nötig — nur Lese-/Schreibzugriff auf das Ziel-Repo für die Beweislieferung.

Docker-Self-Hosting ist für air-gapped Umgebungen und alle, die die Instanz innerhalb ihres eigenen Perimeters haben wollen. 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
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

Die Anwendung ist nach dem Start unter http://localhost:8080 erreichbar. Beim ersten Start führt dich ein Setup-Assistent durch die Verbindung deiner GitHub App und die Konfiguration der Instanz. Self-Hosting erfordert eine Lizenz: Du kannst eine zeitlich begrenzte Demo-Lizenz über die Docker-Lizenzseite mit deinem Namen, deiner Firma, deiner E-Mail-Adresse und optional deiner Telefonnummer anfordern und die Lizenzdatei zur Evaluierung herunterladen.

So bestätigst du, dass es funktioniert hat

Nimm das Badge nicht als Beweis. Bestätige auf drei Ebenen, in zunehmender Strenge.

1. Die Repository-Statusseite. Besuche https://timestampgit.dev/status/{user}/{repo}. Du siehst die Beständigkeit der Beweise, das früheste verankerte Datum, die tägliche Regelmäßigkeit, die Bitcoin-Block- und Transaktionsdaten hinter jeder Verankerung sowie eine Kalender-Heatmap, die zeigt, an welchen Tagen Beweise erzeugt wurden. Die Heatmap ist der schnellste Weg, Lücken zu erkennen.

2. Die Audit-Artefakte. Von der Statusseite oder über die API holst du das Audit-Ledger oder ein Zertifikat pro Datum:

# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-user/your-repo

# PDF certificate for a specific date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-user/your-repo/2026-11-03

Das sind die Dokumente, die du einem Anwalt oder Prüfer übergibst, und die CSV ist das, was ein Compliance-Team tatsächlich gegen interne Aufzeichnungen abgleichen wird.

3. Lokale kryptografische Verifizierung. Die Verifizierungsseite unter https://timestampgit.dev/verification/{user}/{repo}/{date} führt Schritt für Schritt durch die Merkle-Kette, und sämtliche Berechnungen finden lokal in deinem Browser statt. Nichts von dem, was du verifizierst, wird übertragen. Die .ots-Belegdatei desselben Tages liegt in deinem Timestamps-Branch, und jeder kann sie unabhängig mit Standard-OpenTimestamps-Tools gegen die Bitcoin-Blockchain prüfen — kein Konto, kein API-Schlüssel, keine Abhängigkeit davon, dass Timestamp GIT existiert.

Der letzte Punkt ist der, den man gegenüber der Rechtsabteilung wiederholen sollte: Der Beweis besteht aus SHA-256 plus Bitcoin-Blockdaten. Im Vertrauenspfad steckt kein proprietäres Format.

Fehlerbehebung bei häufigen Problemen

Die Beweise sind noch nicht erschienen. Prüfe zuerst die Uhr, bevor du irgendetwas anderes prüfst. Die Verankerung erfordert eine Bitcoin-Bestätigung, die nach dem Mitternachts-Batch normalerweise etwa drei Stunden dauert. Wenn es 2 Uhr morgens ist, ist nichts falsch. Wenn es der nächste Nachmittag ist und der Branch immer noch leer ist, prüfe, ob das Repository tatsächlich in der überwachten Liste steht.

Commits fehlen im Manifest. Fast immer ein Berechtigungs- oder Webhook-Problem. Stelle sicher, dass die GitHub-App-Installation das jeweilige Repository einschließt (Organisations-Installationen gewähren häufig „ausgewählte Repositories“ und übersehen dann eines) und dass die App noch eine aktive Verbindung hat. Prüfe /api/statusCount/{user}/{repo} nach dem nächsten nächtlichen Lauf erneut.

Die Statusseite eines privaten Repos lädt nicht. Private Repositories hängen ein verschlüsseltes HMAC an die URL an, und dieses HMAC ist spezifisch für die Serverinstanz. Kopiere den authentifizierten Badge-Link von der Seite „Repository Connected“, statt eine URL von Hand zu konstruieren — ein abgeschnittenes oder instanzfremdes HMAC schlägt fehl.

Das Docker-Deployment startet nicht. Prüfe, ob die Compose-Datei rue1401/timestampgit:prod und valkey/valkey:8 exakt benennt, ob Port 8080 nicht bereits belegt ist und ob ./data existiert und für den Container beschreibbar ist. docker compose logs -f timestampgit benennt normalerweise die fehlschlagende Abhängigkeit direkt. Wenn die App startet, aber der Setup-Assistent GitHub nicht erreicht, ist die OAuth-Konfiguration die Stelle, an der du nachsehen solltest.

FAQ

Muss ich auf Entwicklermaschinen etwas installieren? Nein. Timestamp GIT ist eine verwaltete GitHub App, die auf GitHubs Infrastruktur und unseren Servern läuft. Entwickler committen einfach wie gewohnt; es sind keine CLI-Tools oder lokale Software erforderlich.

Kann ich Commits in privaten Repositories mit Zeitstempeln versehen? Ja. Private Repositories werden in kostenpflichtigen Plänen unterstützt (Pro Agency oder Enterprise ZK). Die App liest nur Commit-Hashes, niemals deinen Quellcode, und die Beweise werden in einem dedizierten Branch oder Shadow-Repository gespeichert.

Wie lange dauert es, bis ein Zeitstempel unveränderlich wird? Nach dem nächtlichen Batch wird die Merkle-Wurzel in einer Bitcoin-Transaktion verankert. Die Bestätigung dauert typischerweise etwa 3 Stunden, danach ist der Zeitstempel unveränderlich und verifizierbar.

Ist der Beweis anbieterunabhängig? Ja. Der Beweis verwendet nur SHA-256 und Bitcoin-Blockdaten über das OpenTimestamps-Protokoll. Du kannst ihn offline mit Standard-OpenTimestamps-Tools verifizieren, selbst wenn Timestamp GIT nicht mehr existiert.

Was bekommt das Compliance-Team tatsächlich? Eine öffentliche Statusseite, eine herunterladbare Audit-CSV über die Historie des Repositories, ein PDF-Zertifikat pro Datum und .ots-Belege im Repo. Zur rechtlichen Aussagekraft dieser Beweise siehe Is a Blockchain Timestamp Legally Valid Evidence?.

Fazit: Einmal installieren, für immer beweisen

Git-Commits ohne Kommandozeile mit Zeitstempeln zu versehen, läuft auf eine Entscheidung hinaus: Höre auf, Timestamping als Ritual jedes einzelnen Entwicklers zu behandeln, und mache es zu einer Eigenschaft des Repositories. Installiere die GitHub App, wähle die Repos aus, committe weiter. Der nächtliche Cron verwandelt diese Commits in Merkle-verwurzelte, in Bitcoin verankerte Beweise, und die Belege landen wieder in deinem eigenen Repository, wo sie hingehören.

Beginne mit dem kostenlosen Open-Source-Plan in einem öffentlichen Repo — er kostet nichts und dauert etwa fünf Minuten. Wenn du bereit bist, privaten Code abzudecken, wechsle zu Pro Agency für 49 $/Monat, oder nimm Enterprise ZK für 199 $/Monat, wenn das GitHub-Action-Modell besser zu deiner Sicherheitsstrategie passt. So oder so: timestampgit.dev ist der einzige Installationsschritt.

Verwandte Beiträge

EU label: AI-generated content