Zum Inhalt

Installation

Krywerk besteht aus der Desktop-App (für alle, die verschlüsselte Ordner nutzen) und – nur für Team-Ordner – dem Schlüsselserver Krywerk Server, den die IT-Administration einmal für die Organisation betreibt.

Alle Pakete stehen auf der Release-Seite zusammen mit SHA256SUMS.txt (Prüfsummen) und der Stückliste (SBOM).

Noch nicht signiert

Die Pakete der Version 0.9 sind noch nicht mit einem Zertifikat signiert. Windows (SmartScreen) und macOS (Gatekeeper) warnen deshalb beim ersten Start. Die Abschnitte unten beschreiben, wie Sie die App trotzdem öffnen. Prüfen Sie vorher die Prüfsumme:

Get-FileHash .\Krywerk_0.9.0_x64-setup.exe -Algorithm SHA256

sha256sum -c SHA256SUMS.txt --ignore-missing

Desktop-App

Windows 10 und 11

  1. Krywerk_<Version>_x64-setup.exe ausführen und die Rückfrage nach Administratorrechten bestätigen. Der Installer bringt alles mit: Er installiert WinFsp (stellt die Laufwerke bereit), falls es noch fehlt, und unter Windows 10 bei Bedarf die WebView2-Komponente für das Fenster.
  2. Bei „Der Computer wurde durch Windows geschützt“: Weitere Informationen › Trotzdem ausführen (die Vorabversion ist noch nicht signiert).
  3. Krywerk startet über das Startmenü.

Deinstallieren: Einstellungen › Apps › Krywerk. WinFsp bleibt installiert, weil auch andere Programme es nutzen; bei Bedarf separat entfernen.

Verteilung durch die IT (mehrere Rechner): Krywerk_<Version>_x64-setup.exe /S installiert still für alle Benutzer des Rechners, inklusive WinFsp.

macOS

  1. FUSE-T installieren: https://www.fuse-t.org oder brew install macos-fuse-t/homebrew-cask/fuse-t. FUSE-T braucht keine Kernel-Erweiterung.
  2. Krywerk_<Version>_macos-arm64.zip öffnen und Krywerk.app in den Ordner Programme ziehen.
  3. Beim ersten Öffnen: Rechtsklick auf Krywerk.app › Öffnen › Öffnen. Unter macOS 15 ggf. Systemeinstellungen › Datenschutz & Sicherheit › Trotzdem öffnen.

Die Pakete sind für Apple-Silicon-Macs (M1 und neuer) gebaut. Intel-Macs: aus dem Quellcode bauen (siehe unten).

Linux

sudo apt install ./Krywerk_<Version>_amd64.deb

Installiert die App, krywerk-mount, krywerk-recover und krywerk-hub und zieht libfuse 3, WebKitGTK und AppIndicator nach.

chmod +x Krywerk_<Version>_amd64.AppImage
./Krywerk_<Version>_amd64.AppImage

Braucht libfuse 3 (fuse3) der Distribution.

# Arch: sudo pacman -S --needed base-devel fuse3 webkit2gtk-4.1 libayatana-appindicator
# Debian/Ubuntu: sudo apt install build-essential pkg-config libfuse3-dev fuse3 libwebkit2gtk-4.1-dev libayatana-appindicator3-dev
git clone https://github.com/mzilinski/krywerk && cd krywerk
crates/kw-app/linux/install.sh          # nach ~/.local, mit Startmenü-Eintrag

Entfernen: crates/kw-app/linux/install.sh --uninstall.

Passwörter merken braucht einen Schlüsselbund der Sitzung (KWallet oder GNOME-Schlüsselbund). Das Symbol im Infobereich erscheint unter GNOME nur mit der Erweiterung AppIndicator and KStatusNotifierItem Support.

Nur Kommandozeile

Die Archive krywerk-cli_<Version>_<Plattform> enthalten krywerk-mount (Laufwerk), krywerk-hub (Team-Ordner verwalten), krywerk-recover (Boxcryptor-Dateien ohne Laufwerk) und krywerk-server. Entpacken und in den PATH legen; Hilfe mit <programm> --help.

Krywerk Server

Nur nötig für Team-Ordner. Ausführlich in Betrieb von Krywerk Server; hier die Wege im Überblick:

Weg Für Anleitung
Docker Compose mit Caddy (TLS automatisch) Betrieb, empfohlen Betrieb › Installation mit Docker
… zusätzlich mit eigenem Keycloak Anmeldung über Microsoft 365 (Entra ID) Betrieb › Mit eigenem Keycloak
systemd ohne Docker vorhandener Reverse Proxy Betrieb › Ohne Docker
docker-compose.yml im Repository Ausprobieren, Entwicklung unten

Das fertige Image je Version: ghcr.io/mzilinski/krywerk-server:<Version>.

Ausprobieren

git clone https://github.com/mzilinski/krywerk && cd krywerk
cp .env.example .env              # Issuer des Anmeldedienstes eintragen
docker compose up -d --build
curl http://127.0.0.1:8380/health # → ok

Alle Einstellungen: Konfiguration.

Aus dem Quellcode bauen

Voraussetzungen: Rust (stable, mindestens die rust-version aus Cargo.toml), C-Compiler, pkg-config und der Laufwerkstreiber des Systems (WinFsp mit Entwicklerdateien, FUSE-T bzw. libfuse3-dev), unter Linux zusätzlich WebKitGTK 4.1 und AppIndicator.

make build      # alle Programme nach target/release/
make test       # Tests
make help       # alle Ziele