00 DOKU · INSTALLATION

Knot installieren

So installierst du Knot unter macOS und Debian/Ubuntu, vom Download bis zum ersten synchronisierten Speichern. Einen Windows-Build gibt es noch nicht (Abschnitt 03).

macOS · Linux · Windows · Download prüfen · Erstes Speichern

01 MACOS

macOS

BenötigtmacOS 13 (Ventura) oder neuer
CPUIntel nativ · Apple Silicon über Rosetta 2
EnthältDaemon, Desktop-App, CLI, Tor; eigenständig, vorher muss nichts installiert werden

1. Download

Hol dir das Disk-Image aus dem neuesten Release (auch auf der Download-Seite). Die Prüfsumme vorher zu kontrollieren ist optional: Schritte weiter unten.

2. Installieren

Öffne die .dmg, lies die beiliegende INSTALL.txt und zieh Knot in den Ordner Programme (Applications).

3. Erstes Öffnen: der einmalige Gatekeeper-Schritt

Knot ist signiert, aber noch nicht von Apple notarisiert. Deshalb blockiert macOS das erste Öffnen. Der xattr-Befehl entfernt das Quarantäne-Flag vor dem ersten Öffnen. Die Schaltfläche „Dennoch öffnen“ in den Systemeinstellungen erscheint erst, nachdem macOS Knot einmal blockiert hat. Räum die Sperre einmal aus dem Weg, auf eine dieser Arten:

Am zuverlässigsten, jede macOS-Version

xattr -dr com.apple.quarantine "/Applications/Knot.app"
  • Oder: Öffne Knot einmal (es wird blockiert), dann Systemeinstellungen → Datenschutz & Sicherheit → „Dennoch öffnen“.
  • Ältere macOS-Versionen (vor Sequoia): Rechtsklick auf Knot → Öffnen → Öffnen.

4. Erster Start

Öffne Knot. Die Begrüßung in drei Schritten zeigt deine neue Geräte-Identität (kein Konto, kein Passwort: ein Ed25519-Schlüssel, der auf deinem Rechner erzeugt wird) und endet bei Protect a folder. Wähl einen beliebigen Ordner. Jedes Speichern darin wird zu einem echten Git-Commit. Der Daemon startet automatisch mit der App und läuft im Hintergrund weiter.

+ Aktualisieren · Deinstallieren · wo was liegt

Aktualisieren: Lade die neue .dmg herunter und zieh Knot noch einmal in den Ordner Programme, sodass die alte Kopie ersetzt wird. Deine Projekte, deine Identität und deine Kopplungen bleiben unberührt: Sie liegen außerhalb des App-Bundles.

Deinstallieren: Beende Knot und lösche /Applications/Knot.app. Deine Repositorys bleiben, wo sie sind, als normale Ordner mit Git-Historie, die jedes Git-Tool lesen kann.

Speicherorte: Identität und Einstellungen liegen unter ~/Library/Application Support/knot/. Dein Code bleibt genau dort, wo deine Ordner sind.

02 LINUX

Linux (Debian / Ubuntu)

BenötigtDebian/Ubuntu auf x86_64, glibc 2.31+ (Ubuntu 20.04+, Debian 11+)
Abhängigkeitgit (installiert apt automatisch, falls es fehlt)
EnthältDaemon, Desktop-App, CLI, Tor, KI-Laufzeit auf dem Gerät; eigenständig

1. Download

Hol dir das Paket aus dem neuesten Release und vergleich danach optional die Prüfsumme.

2. Installieren (ein Befehl)

sudo apt install ./knot-vcs-amd64.deb

Das vorangestellte ./ sagt apt, dass es eine lokale Datei ist. Die Git-Abhängigkeit löst apt für dich auf. Ein Doppelklick auf die .deb installiert sie nicht. Das aktuelle Ubuntu hat keine grafische Oberfläche, die lokale .deb-Dateien installiert. Das App Center installiert nur Snaps, und das betrifft die .deb jedes Anbieters.

3. Daemon starten

systemctl --user daemon-reload
systemctl --user enable --now knot-vcs

Das Paket registriert den Dienst für alle Benutzer. Diese Befehle schalten ihn für deinen Benutzer ein, sofort und bei jeder Anmeldung.

4. Erster Start

Starte Knot über deinen App-Launcher (oder führ knot-app aus). Du bekommst dieselbe Begrüßung in drei Schritten wie unter macOS. Oder im Terminal, in einem beliebigen Ordner:

knot solo

schaltet für diesen Ordner Dateiüberwachung, Auto-Commit und Sync ein.

+ Aktualisieren · Deinstallieren · Diagnose · andere Distributionen

Aktualisieren: Lade die neuere .deb herunter und führ sudo apt install ./… noch einmal aus. apt aktualisiert an Ort und Stelle. Dein Daemon, deine Projekte und deine Kopplungen bleiben erhalten.

Deinstallieren: sudo apt remove knot-vcs. Dem Paket gehört nichts innerhalb deiner Projektordner. Jeder davon ist danach weiterhin ein Git-Repository, das du mit normalem Git lesen kannst.

Diagnose: knot doctor.

  ✓ daemon reachable
  ⚠ Tor onion not published yet (still bootstrapping, or started without --tor)
  ○ no LAN detected (Tor-only)

Jede Zeile ist eine eigene Prüfung. Auf einem gesunden Rechner siehst du nur die erste. Die Tor-Warnung ist in den ersten Minuten nach einem Kaltstart normal.

Andere Distributionen (Fedora, Arch, …): noch nicht paketiert. Die .deb ist heute das einzige Linux-Artefakt. Ein Snap oder Flatpak ist im Gespräch. Wenn du Knot jetzt auf einer anderen Distribution brauchst, schreib, welche es ist.

03 WINDOWS

Windows

Noch nicht verfügbar. Seit September 2026 lassen sich die Kommandozeile und der Daemon unter Windows 11 bauen und ausführen, und Tor startet dort. Was noch nicht passiert ist: ein Commit, der von einem Windows-Rechner auf einen anderen Rechner gelangt. Genau diese Prüfung haben die macOS- und die Linux-Builds vor dem Release jeweils bestanden, auf dem MacBook und auf dem HP EliteBook. Wenn Windows sie besteht, erscheint der Download hier und im Changelog (EN). Die Desktop-App läuft unter Windows noch nicht.

04 DOWNLOAD PRÜFEN

Download überprüfen

Jedes Release veröffentlicht seine SHA-256-Prüfsummen. Der Vergleich braucht einen Befehl und beweist, dass deine Datei Byte für Byte die Datei aus dem Release ist.

macOS

shasum -a 256 ~/Downloads/Knot-macos.dmg

Linux

sha256sum ~/Downloads/knot-vcs-amd64.deb
Prüfsummen des aktuellen Release
macOS8eb0f6d2d57340e379c878b63077a1a4cb37963e9d7d44764e6a7c1deab9aa84
Linux7e64c9aebca4b57a9e4e9ec0bff2e517ace921681b7da1779aa7c03d6223f938
Dateinamen mit Build-Stempel (Knot-0.1.0+20260826.2319.3fff7c87a-macOS.dmg · knot-vcs_0.1.0+20260826.2319.3fff7c87a434_amd64.deb) hängen ebenfalls am Release: dieselben Bytes unter Namen, die festhalten, aus welchem Build sie stammen.

Es gibt keine CI: Diese Builds werden auf einem einzigen Laptop kompiliert und von Hand auf GitHub Releases hochgeladen.

05 DEIN ERSTER SYNC

Prüfen, ob es geklappt hat

  1. Schütze einen Ordner („Protect a folder“, der letzte Schritt der Begrüßung, oder knot solo im Terminal).
  2. Öffne eine beliebige Datei in diesem Ordner, in einem beliebigen Editor. Ändere etwas. Speichere.
  3. Behalte das Dashboard im Blick. Zuerst läuft eine Debounce-Wartezeit, deshalb passiert es nicht sofort. Was ankommt, ist ein echter Commit, signiert mit deiner Geräte-Identität, und ein normales git log kann ihn lesen.

So synchronisierst du mit einem zweiten Rechner: Installier Knot auch dort und kopple die beiden mit einem Einmalcode aus dem Devices-Tab. Danach wandert jedes Speichern von selbst hinüber. In einem gemeinsamen LAN sprechen die beiden Rechner direkt miteinander, über Tor ist es deutlich langsamer. Auf beiden Wegen sind die Bytes mit Noise verschlüsselt, und jede Seite prüft den Ed25519-Schlüssel der anderen, bevor irgendetwas übertragen wird. Wenn auf beiden Seiten bearbeitet wurde und die Historien auseinandergelaufen sind, führt Knot sie selbst zusammen. Der Merge-Commit wird deterministisch gebaut, aus sortierten Eltern-Commits und einer festen Identität, sodass beide Rechner bei derselben Commit-ID ankommen. Knot hält an, wenn auf beiden Seiten dieselben Zeilen geändert wurden oder wenn die eingehende Seite Änderungen überschreiben würde, die du noch nicht committet hast. Der Push meldet dann push refused: not a fast-forward, die andere Seite wartet unter refs/knot-incoming/, und knot incoming zeigt dir, was dort geparkt ist.

Hängst du fest? Schreib eine Mail mit deiner Betriebssystem-Version und dem, was das Terminal ausgegeben hat.

← Knot · Downloads · Changelog (EN)