# Herunterladen & Installieren

Installieren Sie Oleafly unter macOS, Windows oder Linux und erfahren Sie dann, was die App bei der ersten Nutzung herunterladen kann.

Oleafly zu installieren ist ein Download und ein Doppelklick. Kein Konto, keine Anmeldung und keine separate LaTeX-Distribution: Der Compiler ist in der App enthalten.

## Die App herunterladen

Holen Sie sich den neuesten Installer von der [Releases-Seite](https://github.com/Oleafly/Oleafly/releases/latest) oder verwenden Sie die Schaltfläche zum Herunterladen auf [oleafly.com](https://oleafly.com/), die den Installer für Ihre Plattform ermittelt, wenn möglich.

| Plattform | Download | Was zu tun ist |
|---|---|---|
| macOS (Apple Silicon) | `_aarch64.dmg` | M1 oder neuer. Öffnen Sie das dmg und ziehen Sie Oleafly in den Programme-Ordner. |
| macOS (Intel) | `_x64.dmg` | Intel-Macs. Öffnen Sie das dmg und ziehen Sie Oleafly in den Programme-Ordner. |
| Windows (x86_64) | `.msi` oder `-setup.exe` | Führen Sie einen der beiden Installer aus und folgen Sie den Hinweisen. |
| Linux (x86_64) | `.AppImage`, `.deb` oder `.rpm` | Verwenden Sie das AppImage auf den meisten Distributionen, das Debian-Paket auf Debian-basierten Systemen oder das RPM unter Fedora. |
| Linux (ARM64) | `.AppImage`, `.deb` oder `.rpm` | Native Pakete für ARM64-Linux-Systeme. |

Unter Linux braucht Oleafly glibc 2.35 oder neuer (Stand 2022 oder später: Ubuntu 22.04+, Fedora 36+, Debian 12+).

Sie wissen nicht, welchen Mac Sie haben? Öffnen Sie das Apple-Menü und wählen Sie **Über diesen Mac**. Eine Zeile **Chip** bedeutet Apple Silicon, eine Zeile **Prozessor**, die Intel nennt, bedeutet einen Intel-Mac.

Aktuell ausgeliefert wird für **macOS Apple Silicon**, **macOS Intel**, **Windows x64**, **Linux x64** und **Linux ARM64**. Für Windows auf ARM gibt es noch kein natives Paket.

## Erster Start

### macOS

Öffnen Sie das Disk-Image, ziehen Sie Oleafly in den Programme-Ordner und starten Sie es dann. Verwenden Sie den offiziellen Installer. Blockiert macOS die App, sehen Sie unter **Systemeinstellungen → Datenschutz & Sicherheit** nach der Meldung zum ersten Start.

### Windows

Führen Sie die MSI- oder Setup-Datei aus und folgen Sie dem Installer. Zeigt Windows eine Reputationswarnung, prüfen Sie vor dem Fortfahren, dass der Download vom offiziellen Release stammt. Der Installer legt die Microsoft-Visual-C++-Laufzeitdatei, die Typst und der LaTeX-Language-Server brauchen, neben die App, sodass Sie sie nicht separat installieren müssen.

### Linux

Verwenden Sie das Debian- oder RPM-Paket mit Ihrer Paketverwaltung oder machen Sie das AppImage ausführbar und öffnen Sie es:

```bash
chmod +x Oleafly_*.AppImage
./Oleafly_*.AppImage
```

Oleafly braucht glibc 2.35 oder neuer. Wählen Sie das Paket für die Architektur Ihres Computers.

Die Pakete `.deb` und `.rpm` legen Oleaflys eigene Programme Tectonic, Pandoc und Typst in `/usr/libexec/oleafly` ab und lassen sich deshalb neben dem Pandoc Ihrer Distribution installieren. Wenn Sie das AppImage starten, trägt es sich selbst in Ihr Anwendungsmenü ein. Diesen Eintrag brauchen Wayland-Desktops wie GNOME, bevor sie sein Symbol im Dock zeigen. Das Menü bleibt unangetastet, wenn ein installiertes Paket oder ein anderes Werkzeug Oleafly bereits eingetragen hat, und wenn Sie den Eintrag löschen, bleibt er gelöscht.

Das Debian-Paket bringt eine Beschreibung mit, sodass Ubuntus App Center schon vor der Installation zeigt, was Oleafly ist. Es enthält außerdem AppStream-Daten, sodass Software-Center nach der Installation Symbol, Lizenz, Screenshots und Version zeigen. Die App erscheint im Anwendungsmenü unter Büro. Unter Linux wie unter Windows zeichnet Oleafly seine eigene Titelleiste. Seine Werkzeugleiste liegt oben mit Schaltflächen zum Minimieren, Maximieren und Schließen. Ziehen Sie die Werkzeugleiste, um das Fenster zu verschieben, doppelklicken Sie darauf, um zu maximieren, und ziehen Sie eine Kante oder Ecke, um die Größe zu ändern.

## Das erste Kompilieren lädt TeX-Pakete herunter

Wenn Sie zum ersten Mal ein Dokument mit der mitgelieferten Tectonic-Engine kompilieren, lädt sie die Pakete herunter, die das Dokument braucht, und speichert sie im Cache. Die erste Kompilierung auf einem Rechner holt außerdem auf einen Schlag eine Reihe häufig genutzter Pakete, sodass spätere Dokumente schneller starten. Das erfordert eine Netzwerkverbindung und kann auf einer langsamen Leitung ein paar Minuten dauern. Das Zeitlimit der Kompilierung wartet, solange noch Pakete eintreffen, und fällt Oleaflys Paketspiegel aus, weicht die Kompilierung auf die Upstream-Quelle aus. Spätere Kompiliervorgänge desselben Dokuments sind schnell und funktionieren offline. Ein Dokument, das ein noch nicht zwischengespeichertes Paket braucht, löst einen weiteren einmaligen Abruf aus. Siehe [Kompilieren](/docs/compiling/), inklusive striktem Offline-Modus.

## Optional: eine TeX-Distribution

Tectonic deckt die meisten Dokumente ab. Braucht ein Projekt pdfLaTeX, upLaTeX oder einen anderen Compiler aus einer vollständigen TeX-Distribution, nutzt Oleafly das MacTeX, TeX Live, MiKTeX oder TinyTeX, das schon auf Ihrem Rechner ist. Ist keines da, kann es TinyTeX für Sie installieren, unter **Einstellungen → Engines → LaTeX** oder direkt aus dem Kompilierfehler. TinyTeX braucht keine Administratorrechte, der Download umfasst etwa 250 MB, und Oleafly verlangt etwa 2 GB freien Speicherplatz.

- Unter Linux nutzt TinyTeX das Perl des Systems. Installieren Sie es zuerst, falls es fehlt: `sudo apt install perl`, `sudo dnf install perl` oder `sudo pacman -S perl`.
- Unter Windows braucht MiKTeX Perl, um `latexmk` auszuführen. Installieren Sie Strawberry Perl oder TinyTeX, das ein eigenes mitbringt.
- Unter Debian, Ubuntu und Fedora bekommt ein TeX Live, das Sie mit `apt` oder `dnf` installiert haben, auch seine LaTeX-Pakete über `apt` oder `dnf`. Oleafly sagt Ihnen, was zu installieren ist, ändert es aber nicht selbst.

Siehe [LaTeX-Engines und Pakete](/docs/latex-engines/#latexmk-and-system-tex).

Ihre Dateien bleiben als gewöhnliche Ordner auf der Festplatte. Tokens und KI-Schlüssel liegen in verschlüsselten, auf den Besitzer beschränkten lokalen Dateien. Zu den Online-Funktionen gehören gehostete KI, GitHub-Sync, Paket-Downloads, Zitationsabfragen und Update-Prüfungen. Siehe [Philosophie](/docs/philosophy/).

## Auf dem Laufenden bleiben

Oleafly prüft einen signierten Release-Feed, zeigt Versionshinweise und installiert direkt an Ort und Stelle, wenn Sie bestätigen. Unter Linux funktioniert das automatische Ersetzen bei AppImage-Installationen. Sie können auch unter **Einstellungen → Hilfe & Über** nachsehen. Siehe [Updates](/docs/updates/).

## Aus dem Quellcode bauen

Folgen Sie der [Entwicklungsanleitung für den Desktop](https://github.com/Oleafly/Oleafly/blob/main/docs/development.md) zu Voraussetzungen, Engine-Downloads und lokalen Builds.

## Nächste Schritte

- [Erste Schritte](/docs/getting-started/): vom ersten Projekt zur ersten PDF in wenigen Minuten.
- [Vorlagen](/docs/templates/): mitgelieferte Starter und herunterladbare Pakete.
- [Oleafly Learn](/learn/): kostenloses Curriculum für LaTeX und wissenschaftliches Schreiben im Web.
- [Befehlszeilenwerkzeug](/docs/cli/): Projekte aus einem Terminal bauen, prüfen und abgleichen und Coding-Agenten verbinden.
