OpenMetadata lokal einrichten: Windows, macOS oder Linux wählen

Herausforderung

Lokale Installationen scheitern oft an Ressourcen (RAM/CPU), fehlendem WSL2 unter Windows, veralteten Compose-Dateien oder daran, dass PoC-Secrets und Prod-Connectoren vermischt werden. Manche Teams „installieren erfolgreich“ und halten die Laptop-Instanz für produktionsreif.

Ansatz

OpenMetadata lokal nur zum Lernen und Testen betreiben — mit Docker Desktop. Produktion ist Teil 7 oder 8.

Versions- und Quellenstand: 23.10.2026. Bezugsrelease: OpenMetadata 2.0.6; Anleitung: Quickstart 2.0.x. Release-Assets und Image-Tags vor Start prüfen; Server und Ingestion müssen zusammenpassen. Die Dokumentation kann noch 2.0.5-Beispiele zeigen. Der folgende Download ist bewusst auf 2.0.6 festgelegt und wurde hier nicht ausgeführt. Produktionsupgrades brauchen separat eine Migrations- und Wiederherstellungsprobe.

Voraussetzungen (beide OS):

• Docker Desktop mit mind. 6 GiB RAM und 4 vCPUs für die Linux-VM
• Docker Compose v2 (docker compose version)
• Freier Port 8585 (UI); weitere Ports laut Compose-Datei nicht blockieren
• Genug Disk für Images + docker-volume (mehrere GB)

macOS

Die vollständige Einrichtung einschließlich typischer Fehler steht im eigenen Artikel: macOS.

Windows

Die vollständige Einrichtung einschließlich typischer Fehler steht im eigenen Artikel: Windows.

Stoppen und gespeicherte Daten behalten

Ein normaler Neustart mit docker compose stop und docker compose start behält die Datenvolumes. Werden Volumes ausdrücklich entfernt, gehen ihre Daten verloren. Sichere vorher weiter benötigte Inhalte und entscheide bewusst über das Verwerfen. Ein fehlgeschlagener Start ist kein Grund, alle Volumes zu löschen.

Kurztest nach der Installation

Optional: einen Non-Prod-Sample-Connector anlegen — nie Prod. Für den systematischen Connector-Pfad: Serie openmetadata-connectors.

Linux

Die Linux-Anleitung beschreibt die lokale Engine, Compose und Fehlerdiagnose. Produktionsbetrieb bleibt ein eigener Einrichtungspfad.

Was lokal bewusst fehlt

HA, SSO-Härte, Vault, gehärtetes TLS, On-Call, Kapazitätsplanung Search — siehe Teile 7–10. Wer diese Lücken „später am Laptop“ schließt, baut eine Schatten-Prod.

Häufige Anti-Patterns

• Compose von einem Blog-Post aus 2023 statt vom Release
• Produktion-Service-Principal im lokalen .env
• Proof of Concept-Instanz als „die“ Stewardship-Wahrheit für das Unternehmen
• down -v in Produktion-Denkweise auf dem Laptop — und Überraschung, wenn Lernfortschritt weg ist (für Proof of Concept ok, bewusst entscheiden)

Den ersten Start prüfen

Folge dem eigenen Windows-, macOS- oder Linux-Artikel. Prüfe danach in dieser Reihenfolge: Containerzustand → Oberfläche → Anmeldung → Neustart. Ein leerer Katalog ist bei einer frischen Installation möglich; Beispieldaten oder eine Quelle kommen erst danach hinzu.

Bei einem Startfehler zunächst die Logs des betroffenen Dienstes ansehen. Wenn Docker nicht genügend Speicher erhält, die Ressourcen der Laufzeit prüfen. Eine Quellenanbindung ist eine optionale nächste Aufgabe, kein Nachweis, dass der Installer erfolgreich war.

Checkliste

• RAM/CPU in Docker Desktop gesetzt und verifiziert?
• Compose vom aktuellen Release?
• UI unter 8585 erreichbar; Default-Login dokumentiert?
• Keine Produktions-Secrets im Proof of Concept?
• Ist klar, dass dies eine lokale Testinstanz ist?

Optional festhalten

Version, Betriebssystem, Arbeitsverzeichnis, Compose-Datei und Start-/Stop-Befehle kannst du in den Installationsnotizen sichern. Für den ersten Start genügt die oben beschriebene Funktionsprüfung.

Tools

• OpenMetadata Deployment — aktuelle Compose-/Quickstart-Anleitung.
• OpenMetadata-Ingestions-Generator — optional nur mit Non-Produktion-Umfang (Starter-YAML üben, nicht gegen Produktion).
• Docker Desktop, curl, Browser — lokale Betrieb und Kurztest-Checks.

Ressourcen

• Local Docker Deployment
• GitHub Releases