95 lines
2.9 KiB
Markdown
95 lines
2.9 KiB
Markdown
---
|
||
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).
|