---
title: "DuckDB UI oder DuckLocal: Was passt zu Ihnen?"
description: "DuckDB UI ist ein Browser-Notebook, DuckLocal ein Desktop-Workspace. Die Unterschiede, wann Sie DuckDB UI wählen – und wie Sie es in DuckLocal starten."
language: "de"
---

# DuckDB UI vs DuckLocal: Welches sollten Sie nutzen?

Beide setzen eine lokale Oberfläche auf DuckDB. Das eine ist ein Browser-Notebook, das jeder DuckDB-Prozess öffnen kann; das andere ein Desktop-Workspace rund um Ihre Dateien. Sie beantworten unterschiedliche Bedürfnisse, und Sie können das eine im anderen starten.

![DuckDB UI vs DuckLocal, mit der DuckLocal-Ente am Laptop](https://ducklocal.app/assets/blog/duckdb-ui-vs-ducklocal-cover.webp)

Im März 2025 erschien DuckDB 1.2.1 mit der DuckDB UI: Sie führen `duckdb -ui` aus, und ein Notebook öffnet sich im Browser, getragen von dem DuckDB-Prozess auf Ihrem eigenen Rechner. Seitdem lautet die häufigste Frage, die ich zu DuckLocal bekomme, in etwa *„Warum nicht einfach die DuckDB UI nutzen?“*

Die Frage ist berechtigt. Beide Tools führen DuckDB lokal aus, keines braucht einen Server, den Sie verwalten, und beide halten Ihre Abfragen und Daten auf Ihrem Rechner. Aber sie starten von unterschiedlichen Punkten aus, und dieser Unterschied entscheidet, welches Werkzeug zu einer Aufgabe passt. Dieser Artikel ist mein ehrlicher Versuch, das darzulegen — einschließlich der Fälle, in denen ich selbst zur DuckDB UI greifen würde.

## 1. Die kurze Antwort

| Wenn Sie … | Dann |
| --- | --- |
| bereits in der DuckDB CLI oder in Python arbeiten und diese Sitzung visuell sehen möchten | DuckDB UI |
| in Notebooks aus SQL-Zellen denken | DuckDB UI |
| MotherDuck nutzen oder Ergebnisse darüber teilen möchten | DuckDB UI |
| mit einem Haufen CSV-, Parquet-, JSON- oder Excel-Dateien und -Ordnern starten | DuckLocal |
| offline arbeiten müssen oder möchten, dass jeder Teil des Tools installiert und prüfbar ist | DuckLocal |
| Diagramme und Dashboards möchten, die Sie als Dateien speichern und in git halten können | DuckLocal |
| möchten, dass ein KI-Agent dieselben Daten von einem Terminal aus abfragt | DuckLocal |
| beides auf denselben Daten möchten | DuckLocal, dann `CALL start_ui();` |

## 2. Was die DuckDB UI ist

Die DuckDB UI wird von MotherDuck entwickelt und gepflegt und als DuckDB-Erweiterung namens `ui` ausgeliefert. Sie starten sie mit `duckdb -ui` im Terminal oder mit `CALL start_ui();` aus einem beliebigen DuckDB-Client — der CLI, Python, Java und so weiter.

Die Erweiterung startet einen HTTP-Server auf `localhost` (standardmäßig Port 4213) innerhalb des DuckDB-Prozesses, der sie aufgerufen hat, und öffnet Ihren Browser. Weil die UI mit genau diesem Prozess spricht, sieht sie alles, was der Prozess sieht: seine angehängten Datenbanken, seinen Speicher und Ihre lokalen Dateien.

Das bekommen Sie im Browser:

- **Notebooks** — benannte, gespeicherte Sammlungen von SQL-Zellen mit Syntaxhervorhebung und Autovervollständigung. Eine Zelle kann mehrere Anweisungen enthalten.

- **Ein Browser für angehängte Datenbanken** mit Tabellenübersicht: Zeilenzahl, Spalten, Typen und ein Profil pro Spalte.

- **Ein Column Explorer**, der ein Ergebnis zusammenfasst und Ihnen erlaubt, in jede Spalte einzusteigen.

- **Optionale MotherDuck-Anmeldung**, um Tabellen im Cloud-Warehouse von MotherDuck zu speichern und zu teilen. Sie ist optional; standardmäßig verlässt nichts Ihren Rechner.

Zwei Details sind für den Vergleich wichtig. Erstens: Der lokale Server der Erweiterung **lädt die Frontend-Dateien der UI von `https://ui.duckdb.org`**, damit die Oberfläche aktuell bleibt; Ihre Abfragen laufen weiterhin lokal, aber die UI selbst wird aus dem Netz geladen. Offline-Nutzung war zum Start nicht unterstützt. Zweitens: Die Erweiterung steht unter MIT-Lizenz, während der Quellcode des Frontends zum Start nicht veröffentlicht war.

Quellen: [Ankündigung der DuckDB UI](https://duckdb.org/2025/03/12/duckdb-ui) · [Dokumentation der UI-Erweiterung](https://duckdb.org/docs/current/core_extensions/ui.html) · [duckdb/duckdb-ui auf GitHub](https://github.com/duckdb/duckdb-ui). Prüfen Sie dort Änderungen, die nach diesem Artikel entstanden sind.

## 3. Direkter Vergleich

| Dimension | DuckDB UI | DuckLocal |
| --- | --- | --- |
| Was es ist | Ein Browser-Notebook, bereitgestellt von DuckDBs `ui`-Erweiterung | Eine native Desktop-App mit eingebettetem DuckDB |
| Wie Sie es starten | `duckdb -ui` oder `CALL start_ui();` aus einem beliebigen DuckDB-Client (1.2.1 oder neuer) | Die App öffnen oder `ducklocal ./data/` ausführen |
| Wo Abfragen laufen | In dem DuckDB-Prozess, der sie gestartet hat, auf Ihrem Rechner | Im eingebetteten DuckDB von DuckLocal, auf Ihrem Rechner |
| Oberflächen-Dateien | Werden vom lokalen Server von `ui.duckdb.org` geladen | Sind in der App enthalten |
| Offline | Braucht Netzwerk für die UI-Dateien | Funktioniert offline; das Netzwerk wird nur für S3, Kartenkacheln, Erweiterungs-Installationen und Update-Prüfungen genutzt, die Sie einschalten |
| Daten einbringen | SQL: `read_csv`, `ATTACH` oder was die Sitzung bereits hat | Dateien, Ordner und Glob-Muster hineinziehen; sie werden zu Views und sind beim nächsten Start wieder da |
| Arbeitsweise | Notebooks aus SQL-Zellen | Abfrage-Tabs, eine Schema-Sidebar, Verlauf, `EXPLAIN` und ein Profiler |
| Ergebnisse erkunden | Tabellenübersichten und der Column Explorer | Ergebnisraster, ein Overview-Tab pro Spalte und eingebaute Diagramme |
| Wiederverwendung und Teilen | Gespeicherte Notebooks; optionales Teilen über MotherDuck | Klartext-Dashboards im `.dash`-Format, die Sie prüfen und in git halten können, mit Plot-Kommentaren |
| KI-Agenten | Nicht der Fokus | `ducklocal`-CLI mit begrenzter JSON-Ausgabe und ein offizieller Agent-Skill |
| Quelle | Erweiterung unter MIT; Frontend zum Start nicht veröffentlicht | Apache-2.0, App und Quellcode auf GitHub |
| Plattformen | Überall, wo DuckDB läuft, außer `windows_arm64` | macOS auf Apple Silicon, Windows x64, Linux x86_64 |

Am kürzesten gesagt: **Die DuckDB UI ist ein Fenster auf eine DuckDB-Sitzung, die Sie schon haben. DuckLocal ist die Sitzung selbst, gebaut um die Dateien, die Sie ansehen möchten.**

## 4. Wann Sie die DuckDB UI nutzen

### Sie leben ohnehin in DuckDB

Wenn Ihre Arbeit in der DuckDB CLI oder in einem Python-Skript stattfindet, ist die UI nur einen Befehl entfernt und braucht keine neue App. Führen Sie `duckdb -ui my.duckdb` aus oder rufen Sie `start_ui()` aus dem Python-Prozess auf, der Ihre Daten bereits geladen und umgeformt hat — und Sie sehen genau diesen Zustand. DuckLocal kann nicht in einen anderen Prozess hineinschauen; die UI ist dafür gebaut.

### Sie denken in Notebooks

Manche Analyse ist eine lange Folge von Schritten, die Sie in dieser Reihenfolge behalten möchten: laden, bereinigen, verknüpfen, prüfen, zusammenfassen. Notebooks mit benannten, gespeicherten Zellen passen gut dazu, und eine Zelle kann mehrere Anweisungen auf einmal ausführen. Die Abfrage-Tabs von DuckLocal eignen sich besser für viele einzelne Fragen als für eine lange Erzählung.

### Sie nutzen MotherDuck

Wenn Ihr Team Daten bereits über MotherDuck teilt, ist die UI die natürliche Oberfläche dafür: anmelden, und dasselbe Notebook erreicht sowohl lokales DuckDB als auch Ihr Cloud-Warehouse. DuckLocal hat keinen Cloud-Dienst und plant keinen.

### DuckLocal hat keinen Build für Ihren Rechner

DuckLocal erscheint für macOS auf Apple Silicon, Windows x64 und Linux x86_64. Auf einem Intel-Mac müssten Sie DuckLocal zum Beispiel aus dem Quellcode bauen, während die DuckDB UI überall läuft, wo DuckDB läuft (außer Windows auf ARM).

## 5. Wann Sie DuckLocal nutzen

### Sie starten mit Dateien, nicht mit SQL

Ziehen Sie eine CSV, einen Ordner mit Parquet-Dateien oder ein Muster wie `./logs/2026-*/*.json` hinein, und jede davon wird zu einer View, die Sie abfragen können, mit ihren Spalten in der Sidebar. Jedes nicht leere Blatt einer Excel-Arbeitsmappe wird zu einer Tabelle. Nichts muss zuerst als `read_csv(…)` geschrieben werden, und die Dateien sind beim nächsten Öffnen der App noch da.

### Es muss offline funktionieren oder vollständig prüfbar sein

Die Oberfläche von DuckLocal ist Teil der App, die Sie installiert haben. Sie lädt zur Laufzeit keinen Oberflächencode, sie lädt keine Erweiterungen von selbst herunter, und Update-Prüfungen sind aus, bis Sie sie einschalten. Das Frontend der DuckDB UI wird dagegen beim Start geladen und kann die in DuckDB geladenen Daten lesen — die DuckDB-Dokumentation selbst rät, es nur auf eine URL zu richten, der Sie vertrauen. Für die meisten Menschen ist das in Ordnung. Für Sicherheitsprüfungen, Audits, regulierte Daten oder abgeschottete Rechner ist „alles ist installiert und Open Source“ die stärkere Zusicherung.

### Sie möchten Diagramme und Dashboards als Dateien

Ergebnisse werden direkt zu Balken-, Linien-, Streu-, Kreis- und Kartendiagrammen. Wenn eine Ansicht es wert ist, behalten zu werden, beschreibt eine [`.dash`-Datei](https://ducklocal.app/docs/de/dashboards) ihre Abfragen, Plots und Filter als Klartext — etwas, das Sie diffen, in einem Pull Request prüfen und mit `ducklocal check` validieren können.

### Sie arbeiten mit einem KI-Agenten

Die [`ducklocal`-CLI](https://ducklocal.app/de/use-cases/ai-agent-sql/) gibt einem Agenten einen schema-first Ablauf mit einer SQL-Anweisung pro Schritt und begrenzter JSON-Ausgabe, und Dashboard-Kommentare erlauben es Ihnen, ihm eine Frage zu einem bestimmten Diagramm zu übergeben. Dieselben Dateien sind in der App geöffnet, damit Sie seine Arbeit prüfen können.

## 6. Die DuckDB UI in DuckLocal starten

Sie müssen sich nicht entscheiden. Die DuckDB UI ist eine Erweiterung, und DuckLocal kann DuckDB-Erweiterungen laden — also läuft die UI auf DuckLocals eigener DuckDB-Instanz:

- Öffnen Sie den Tab **Erweiterungen** in der Sidebar von DuckLocal.

- Klicken Sie auf **Installieren** in der Zeile `ui`, dann auf **Laden**. DuckLocal installiert niemals von selbst Erweiterungen, dieser Schritt ist also bewusst.

- Führen Sie in einem Abfrage-Tab aus:

```text
CALL start_ui();
```

Ihr Browser öffnet die DuckDB UI unter `http://localhost:4213`. Sie hängt an der DuckDB-Instanz, die DuckLocal ausführt, sodass die Dateien, die Sie in DuckLocal geöffnet haben, in einem Notebook bereitstehen.

![DuckLocals Tab Erweiterungen mit der als geladen markierten ui-Erweiterung, daneben der Startbildschirm zum Ablegen der Daten](https://ducklocal.app/assets/blog/ducklocal-extensions-ui.webp)

*Die `ui`-Erweiterung, geladen im Tab Erweiterungen von DuckLocal. Von hier aus öffnet `CALL start_ui();` die DuckDB UI auf derselben DuckDB-Instanz.*

Ein paar Dinge, die gut zu wissen sind:

- **Es braucht das Netzwerk:** einmal, um `ui` zu installieren, und bei jedem Start, um die UI-Dateien von `ui.duckdb.org` zu laden.

- **Es endet mit DuckLocal.** Beim Beenden von DuckLocal schließt sich seine DuckDB-Instanz und damit der UI-Server. `CALL stop_ui_server();` stoppt ihn früher, und `CALL start_ui_server();` startet ihn, ohne einen Browser zu öffnen.

- **Notebooks gehören zur Erweiterung,** gespeichert in `~/.duckdb/extension_data/ui/`. Der Abfrageverlauf von DuckLocal enthält nicht, was Sie in der UI ausführen.

- **Auf einer schreibgeschützten Datenbank läuft sie nicht direkt.** Hängen Sie diese Datenbank stattdessen aus einem Notebook mit `ATTACH '…' (READ_ONLY)` an.

So nutze ich beide zusammen: DuckLocal, um die Daten zu öffnen, die Spalten anzusehen und die naheliegenden Fragen zu visualisieren; die DuckDB UI, wenn aus einer Frage eine längere Untersuchung wird, die ich als Notebook behalten möchte.

Dokumentation: [DuckDB UI aus DuckLocal öffnen](https://ducklocal.app/docs/de/schema-and-history#duckdb-ui) · [Tab Erweiterungen](https://ducklocal.app/docs/de/schema-and-history#extensions)

## 7. FAQ

### Was ist der Unterschied zwischen DuckDB UI und DuckLocal?

DuckDB UI ist ein Browser-Notebook, das die `ui`-Erweiterung von DuckDB aus demjenigen DuckDB-Prozess bereitstellt, der sie startet. DuckLocal ist eine native Desktop-App mit eingebettetem DuckDB, gebaut um das Öffnen von Dateien und Ordnern, Diagramme, Klartext-Dashboards und eine CLI für KI-Agenten. Beide führen Abfragen lokal aus.

### Ist DuckLocal ein Ersatz für die DuckDB UI?

Nein. Sie überschneiden sich beim Ausführen von SQL auf lokalen Daten, aber die UI eignet sich am besten als Fenster auf eine bestehende DuckDB-Sitzung und DuckLocal als Workspace für Dateien. Da die UI in DuckLocal läuft, können Sie beides nutzen.

### Funktioniert die DuckDB UI offline?

Ihre Abfragen laufen lokal, aber die Frontend-Dateien der UI werden bei jedem Start von `ui.duckdb.org` geladen, daher braucht sie Netzwerkzugriff. Die Oberfläche von DuckLocal ist in der App enthalten und funktioniert offline.

### Gehen meine Abfragen an MotherDuck?

Nicht, solange Sie sich in der UI nicht bei MotherDuck anmelden. Standardmäßig führt die DuckDB UI Ihre Abfragen auf Ihrem eigenen Rechner aus, so wie DuckLocal.

## Verwandte Links

- [Die lokale DuckDB UI (DuckDB-Blog)](https://duckdb.org/2025/03/12/duckdb-ui)

- [Dokumentation der UI-Erweiterung](https://duckdb.org/docs/current/core_extensions/ui.html)

- [Lokale Datenanalyse mit DuckLocal](https://ducklocal.app/de/use-cases/local-data-analysis/)

- [Was Claude Dashboards mir über DuckLocal beigebracht hat](https://ducklocal.app/de/blog/claude-dashboards-ducklocal/)

[← Alle Beiträge](https://ducklocal.app/de/blog/)

Source: https://ducklocal.app/de/blog/duckdb-ui-vs-ducklocal/
