Initial commit: Rapport Website (Hugo + Hextra)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-26 11:52:03 +02:00
commit e007bdd4e7
480 changed files with 41697 additions and 0 deletions
@@ -0,0 +1,94 @@
+---
+title: Installation
+linkTitle: Installation
+weight: 2
+toc: true
+---
+
+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](https://git.kgva.ch/karim/RAPPORT/issues/new), wenn du eine Plattform brauchst.
+
+## 1 · Download
+
+Aktueller Build: [Downloads-Seite](../../downloads) oder direkt [Releases auf Gitea](https://git.kgva.ch/karim/RAPPORT/releases).
+
+| 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:
+
+```bash
+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](../einrichtung).
+
+## 5 · Update-Strategie
+
+Ab Version 0.7.0 prüft Rapport beim Start automatisch auf neue Versionen (siehe [Auto-Updater](../../features/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](../datenhaltung)).
+
+## Deinstallation
+
+```bash
+# 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](../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](../troubleshooting).