---
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.openbureau.ch/karim/RAPPORT/issues/new), wenn du eine Plattform brauchst.

## 1 · Download

Aktueller Build: [Downloads-Seite](../../downloads) oder direkt [Releases auf Gitea](https://git.openbureau.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).
