Zum Inhalt springen
`CTRL K`

Dokumentation
Installation

# Installation

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

## Voraussetzungen

Plattform | Status | Versionen
--- | --- | ---
macOS Apple Silicon (M1 – M4) | ✅ Unterstützt | macOS 12+
macOS Intel | ⚠ Build auf Anfrage | macOS 12+
Linux | 🕐 Geplant | —
Windows | 🕐 Geplant | —

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
.

Datei | Plattform
--- | ---
`RAPPORT_<version>_aarch64.dmg` | macOS Apple Silicon
`RAPPORT_<version>_x86_64.dmg` | macOS Intel (auf Anfrage)

## 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

Problem | Lösung
--- | ---
App lässt sich nicht öffnen trotz Freigabe | Terminal-Variante mit `xattr`
“Rapport is damaged” | DMG erneut von Gitea ziehen (Browser-Cache hat evtl. Müll)
Schwarzer Bildschirm beim Start | `~/Library/WebKit/com.rapport.app` löschen, neu starten

Mehr unter Troubleshooting.

Erste Schritte Einrichtung