# Erste Schritte

> DuckLocal unter macOS, Windows oder Linux installieren, das ducklocal-CLI hinzufügen, eine Datei öffnen und die erste DuckDB-SQL-Abfrage ausführen.

Source: https://ducklocal.app/docs/de/getting-started

DuckLocal ist eine Desktop-App, mit der Sie Fragen an die Datendateien auf Ihrem
Rechner in SQL stellen. Es gibt keinen Server, keine Verbindung zum Einrichten und
kein Konto — Sie zeigen auf Dateien und beginnen mit dem Abfragen. Diese Seite
führt Sie in etwa fünf Minuten vom Download zum ersten Ergebnis.

## 1. Installieren {#install}

DuckLocal läuft unter macOS, Windows und Linux. Die folgenden Links laden das neueste Release von `dl.ducklocal.app` herunter; dieselben Dateien und Release Notes finden Sie auf [GitHub](https://github.com/JetSquirrel/DuckLocal/releases/latest).

Diese Anleitungen sind für [v0.4.1](https://github.com/JetSquirrel/DuckLocal/releases/tag/v0.4.1) aktualisiert, veröffentlicht am 15. November 2026. Version 0.4.0 ergänzte [Agent-Workflows](agent-workflows.md): eingeschränktes SQL, eine geprüfte Übergabe an das Fenster, Dashboard-Vorschläge, Analyseaufzeichnungen und portable Projekte. Version 0.4.1 ergänzt Mehrfachauswahl-Filter, eine Zeitzone und ein Zeitstrahl-Diagramm für Dashboards, `view`-Blöcke, die gemeinsames SQL einmal halten, Community-Erweiterungen wie `mssql` im Tab „Erweiterungen“ und eine Rückfrage zum Speichern für Tabellen, die in der In-Memory-Datenbank angelegt wurden. Wenn Sie von einer Version vor 0.3.0 aktualisieren, installieren Sie Ihre Erweiterungen neu: Mit diesem Release wechselte DuckLocal auf DuckDB 2.0.

### Mac

Sie brauchen **macOS 12 oder neuer auf Apple silicon** (M1 oder neuer).

1. Laden Sie [`ducklocal-macos-arm64.dmg`](https://dl.ducklocal.app/latest/ducklocal-macos-arm64.dmg) herunter.
2. Öffnen Sie die Datei und ziehen Sie **DuckLocal** auf **Programme**.
3. Starten Sie DuckLocal über Programme oder Spotlight.

Das Disk-Image ist von Apple signiert und notarisiert und öffnet sich daher ohne
Umweg über Gatekeeper.

### Windows

Sie brauchen **64-Bit Windows 10 oder neuer**.

1. Laden Sie [`ducklocal-windows-x86_64.zip`](https://dl.ducklocal.app/latest/ducklocal-windows-x86_64.zip) herunter und entpacken Sie sie.
2. Führen Sie `ducklocal.exe` aus dem entpackten Ordner aus. Der Build ist noch nicht
   code-signiert, daher kann beim ersten Start **Windows hat Ihren PC geschützt**
   erscheinen — wählen Sie **Weitere Informationen** und dann **Trotzdem ausführen**.

### Linux

Sie brauchen ein **x86_64**-System mit **glibc 2.35 oder neuer** (Ubuntu 22.04,
Debian 12, Fedora 36 oder neuer) und Grafiktreiber mit Vulkan-Unterstützung.

```bash
curl -LO https://dl.ducklocal.app/latest/ducklocal-linux-x86_64.tar.gz
tar -xzf ducklocal-linux-x86_64.tar.gz
./ducklocal-linux-x86_64/ducklocal
```

::: details Stattdessen aus dem Quellcode bauen
Sie brauchen Rust stable 1.85.1 oder neuer und eine C++-Toolchain (Xcode Command Line
Tools). DuckDB wird aus mitgelieferten Quellen kompiliert, daher dauert der erste Build
mehrere Minuten und belegt ein paar Gigabyte Plattenplatz.

```bash
git clone https://github.com/JetSquirrel/DuckLocal
cd DuckLocal
cargo build --release
./target/release/ducklocal
```

Die Binary ist `./target/release/ducklocal`; verwenden Sie sie überall dort, wo diese
Anleitung `ducklocal` nennt. Wie Sie ein `.app` bündeln, steht unter [Entwicklung](development.md).
:::

## 2. Den Befehl `ducklocal` hinzufügen (optional) {#add-command}

Alles in der App funktioniert ohne Terminal. Wenn Sie Daten auch von der
Kommandozeile öffnen möchten — oder einen KI-Agenten sie mit der
[CLI](cli.md) analysieren lassen wollen —, fügen Sie den Befehl in der App hinzu:

1. Klicken Sie auf die Roboter-Schaltfläche in der Titelleiste oder wählen Sie
   **DuckLocal → Kommandozeile & KI…** in der Menüleiste.
2. Klicken Sie auf **Befehl installieren**. Auf einem Mac fragt das System nach Ihrem
   Passwort, um nach `/usr/local/bin` zu schreiben.
3. Öffnen Sie ein neues Terminal und prüfen Sie ihn: `ducklocal --version`.

Der Befehl ist ein Link auf die App, daher aktualisiert ein DuckLocal-Update auch
den Befehl. Zum Aktualisieren klicken Sie auf die Version am rechten Ende der
Statusleiste: Ein neueres Release wird heruntergeladen und beim Neustart installiert (siehe [Update-Prüfung](settings-and-data.md#update-check)). Auf einem Mac liegt er in
`/usr/local/bin`, unter Linux in `~/.local/bin`; unter Windows wird der Ordner der App
zu Ihrem `Path` hinzugefügt.

Im selben Dialog installiert **Zu Claude Code hinzufügen** die DuckLocal-Skill, sodass
Claude Code weiß, wie es Ihre Dateien abfragt, und **Kurzbeschreibung kopieren** kopiert
eine kurze Erklärung, die Sie in jeden anderen KI-Agenten einfügen können. Siehe
[KI-CLI und offizielle Skill](cli.md#install-the-official-skill).

::: details Manuell hinzufügen
```bash
sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/DuckLocal.app/Contents/MacOS/ducklocal /usr/local/bin/ducklocal
```

Zum Entfernen: `sudo rm /usr/local/bin/ducklocal`. Unter Linux verlinken Sie die
entpackte Binary nach `~/.local/bin`; unter Windows fügen Sie den entpackten Ordner zu
Ihrem `Path` hinzu.
:::

## 3. Daten öffnen

Beim ersten Start beginnt eine kurze Anleitung, geführt von der Ente: den
KI-Agenten einbinden, Daten öffnen, die Seitenleiste, eine Abfrage ausführen und ihre
Ergebnisse lesen. **Überspringen** schließt sie bei jedem Schritt. Um sie erneut zu
sehen, wählen Sie **Anleitung anzeigen** im Menü **DuckLocal** auf einem Mac oder im
Kontextmenü der Version am rechten Ende der Statusleiste.

Dahinter liegt ein Bildschirm mit dem Titel **Daten hier ablegen**. Von hier aus führen
alle diese Wege zu Daten:

- **Ziehen** Sie CSV-, TSV-, Parquet-, JSON- oder Excel-Dateien — oder einen ganzen
  Ordner — auf das Fenster.
- Klicken Sie auf **Dateien öffnen** oder **Ordner öffnen**.
- Auf einem Mac **doppelklicken** Sie eine `.parquet`- oder `.duckdb`-Datei im Finder oder
  wählen DuckLocal für CSV-, JSON- und Excel-Dateien unter **Öffnen mit**. Siehe
  [Im Finder öffnen](data-sources.md#open-from-finder).
- Aus einem Terminal nennen Sie die Pfade:

  ```bash
  ducklocal ./sales.csv         # eine Datei
  ducklocal ./logs/             # jede Datendatei unter einem Ordner, rekursiv
  ducklocal './data/*.parquet'  # ein Muster — in Anführungszeichen setzen, damit die Shell es nicht vorher expandiert
  ducklocal warehouse.duckdb    # eine bestehende DuckDB-Datenbank
  ```

Jede Datei wird zu einer View, die nach der Datei benannt ist — `sales.csv` wird zu
`sales` —, und erscheint unter **Lokale Dateien** in der Seitenleiste mit ihren Spalten
und ihrer Zeilenzahl. DuckLocal liest die Dateien an ihrem Ort; nichts wird kopiert oder
hochgeladen.

Geöffnete Dateien werden gemerkt, sodass der nächste Start mit demselben Workspace
beginnt. Details zu Formaten, Ordnern, Mustern und Datenbanken finden Sie unter
[Datenquellen](data-sources.md).

Auf einem Mac können Sie auch vor dem Öffnen in eine Datei hineinschauen: Wählen Sie sie
im Finder aus und drücken Sie die **Leertaste**. Die [Quick-Look-Vorschau](data-sources.md#quick-look)
von DuckLocal zeigt die Spalten und ersten Zeilen von Parquet-, DuckDB-, CSV-, TSV- und
JSON-Lines-Dateien.

::: tip Keine Daten zur Hand?
Das [Tutorial für die ersten 10 Minuten](tutorial.md) führt Schritt für Schritt durch eine kleine Beispieldatei.
:::

## 4. Eine Abfrage ausführen

Klicken Sie auf **Neue Abfrage** (oder öffnen Sie Daten — der Editor erscheint von
selbst). Geben Sie SQL ein und drücken Sie **⌘↵** (Cmd+Enter; unter Windows und Linux
Ctrl+Enter):

```sql
SELECT * FROM sales LIMIT 20;
```

Ersetzen Sie `sales` durch einen beliebigen View-Namen aus Ihrer Seitenleiste.

Das Ergebnis erscheint im Bereich unter dem Editor. Wechseln Sie zu **Diagramm** für ein
schnelles Bild, oder exportieren Sie es als CSV oder Parquet. Die Symbolleiste über dem
Editor enthält **Ausführen**, **Formatieren** und **EXPLAIN**.

Ein Tastenkürzel, das sich lohnt: Klicken Sie in der Seitenleiste auf die Play-Schaltfläche
neben einer Tabelle, um ein fertiges `SELECT * … LIMIT 100` zu erhalten, oder auf einen
Spaltennamen, um nur diese Spalte auszuwählen.

## Wie es weitergeht

- [Ihre ersten 10 Minuten](tutorial.md) — eine geführte Tour mit Beispieldaten
- [Datenquellen](data-sources.md) — Formate, Ordner, Muster, Datenbanken, Finder und Quick Look
- [SQL-Editor](sql-editor.md) — Tabs, Tastenkürzel, Autovervollständigung, EXPLAIN
- [Ergebnisse und Diagramme](results-and-charts.md) — Filtern, Exportieren, Diagramme, die Spaltenübersicht
- [Dashboards (.dash)](dashboards.md) — Dashboards als Textdateien und ihre Prüfung mit einem KI-Agenten
- [Fehlerbehebung](troubleshooting.md) — wenn etwas nicht wie erwartet funktioniert
