Wie man Qdrant Docker Desktop mit Windows startet

Wenn du Qdrant auf deinem Windows-Rechner ausführen möchtest, ist es wichtig, die richtigen Parameter für Docker zu verwenden. Besonders bei der Verwendung von Docker Desktop unter Windows gibt es einige Besonderheiten, die man beachten muss.

In diesem Tutorial zeigen wir dir, wie du Qdrant mit Docker Desktop auf Windows startest – ohne Fehlermeldungen oder Permission-Probleme.

Das Problem

Das folgende Kommando sieht auf den ersten Blick harmlos aus:

docker run -p 6333:6333 -p 6334:6334 \
  -v "$(pwd)/qdrant_storage:/qdrant/storage:z" \
  qdrant/qdrant

Aber wenn du es auf Windows ausführst, tritt ein Problem auf:

  • $(pwd) funktioniert nur in Bash, nicht im PowerShell oder CMD.
  • Der Parameter :z ist für Linux spezifisch und wird unter Windows ignoriert.
  • Lokale Ordner-Mounts können unter Windows aufgrund von Berechtigungen oder WSL-Einstellungen fehlschlagen.

Ein häufiger Fehler bei der Verwendung von Docker Desktop unter Windows ist, dass lokale Dateisysteme nicht immer korrekt gemountet werden – besonders wenn du mit WSL2 arbeitest.

Lösung: Verwende einen benannten Docker-Volumen

Die empfohlene Vorgehensweise lautet:

  1. Erstelle ein benanntes Volume
  2. Starte Qdrant mit diesem Volume

1. Benanntes Volume erstellen

Öffne zunächst deine PowerShell oder CMD, und führe folgenden Befehl aus:

docker volume create qdrant_storage

Dieser Befehl erstellt ein Docker-Volumen namens qdrant_storage, das sicher von Qdrant genutzt werden kann – ohne Probleme mit Pfaden oder Berechtigungen.

2. Qdrant starten

Jetzt kannst du Qdrant mit dem folgenden Befehl starten:

docker run -p 6333:6333 -p 6334:6334 -v qdrant_storage:/qdrant/storage qdrant/qdrant

🧪 Was passiert jetzt?

Wenn alles funktioniert, siehst du etwas Ähnliches in deiner Konsole:

Creating network "qdrant_default" with the default driver
Creating qdrant ... done
Attaching to qdrant
qdrant    | [2024-04-05T10:00:00Z INFO  qdrant::startup] Qdrant v1.7.0 starting...

Du kannst nun auf Qdrant zugreifen:

  • Webinterface: http://localhost:6333
  • API: http://localhost:6334

📝 Fazit

Docker Desktop unter Windows kann manchmal etwas kniffelig sein, besonders wenn es um lokale Dateisysteme geht. Mit der Verwendung eines benannten Volumens vermeidest du viele Fehlerquellen und machst deine Installation robuster.

Zusammenfassung:

  1. Erstelle ein benanntes Volume: docker volume create qdrant_storage
  2. Starte Qdrant mit dem Volume:
   docker run -p 6333:6333 -p 6334:6334 `
     -v qdrant_storage:/qdrant/storage `
     qdrant/qdrant

Jetzt bist du bereit, Qdrant auf deinem Windows-Rechner zu betreiben – ohne Stress!

💡 Tipp: Falls du später mehrere Instanzen von Qdrant testen möchtest, kannst du einfach weitere benannte Volumina erstellen und diese jeweils in verschiedenen Containern nutzen.

Previous

Next