Installation

Schritt-für-Schritt-Anleitung für die Installation der Desktop-App.

Voraussetzungen

Eine Portierung auf Linux und Windows ist mit Tauri 2 möglich. Issue erstellen, wenn du eine Plattform brauchst.

1 · Download

Aktueller Build: Downloads-Seite oder direkt Releases auf Gitea.

2 · DMG öffnen & installieren

1. DMG doppelklicken
2. Rapport.app in den Applications-Ordner ziehen
3. DMG auswerfen

3 · Erster Start (macOS Gatekeeper)

Beim ersten Start verweigert macOS den Start, weil die Pre-Release-Builds Tauri-signiert, aber (noch) nicht Apple-notarisiert sind.

Lösung

1. Systemeinstellungen → Datenschutz & Sicherheit öffnen
2. Bis ganz nach unten scrollen — es erscheint:

   “Rapport” wurde blockiert, da es nicht von einem identifizierten Entwickler stammt.

3. Auf “Trotzdem öffnen” klicken
4. Bestätigen

Ab dem zweiten Start läuft Rapport ohne Rückfragen.

Alternative (Terminal)

Falls der GUI-Weg nicht funktioniert:

xattr -d com.apple.quarantine /Applications/Rapport.app

Das entfernt das Quarantäne-Flag und macOS akzeptiert den Start.

4 · Erstes Setup

Beim ersten Start zeigt Rapport den Setup-Bildschirm. Hier werden die Stammdaten erfasst — siehe Einrichtung.

5 · Update-Strategie

Ab Version 0.7.0 prüft Rapport beim Start automatisch auf neue Versionen (siehe Auto-Updater). Updates können in den Einstellungen deaktiviert werden.

Manuelle Updates: einfach das neuere DMG installieren — die Daten bleiben erhalten, da sie unabhängig von der App liegen (siehe Datenhaltung).

Deinstallation

# App entfernen
rm -rf /Applications/Rapport.app

# Daten entfernen (optional!)
rm -rf "~/Library/Application Support/com.rapport.app"

# Caches
rm -rf "~/Library/Caches/com.rapport.app"
rm -rf "~/Library/WebKit/com.rapport.app"

Achtung: Schritt 2 löscht alle Rapport-Daten unwiederbringlich. Vorher Backup machen — siehe Datenhaltung.

Bekannte Probleme

Mehr unter Troubleshooting.