Windows: WSL und Docker
Docker Desktop führt POSIM aus; WSLg zeigt Gazebo auf dem Windows-Desktop an. Führen Sie die Docker-Befehle dieser Seite im Ubuntu-Terminal innerhalb von WSL aus.
1. WSL und Grafik vorbereiten
Folgen Sie den ersten beiden Schritten der Windows-Installation: Ubuntu 26.04 in WSL2 installieren, anschließend WSL und den Windows-Grafiktreiber aktualisieren. Das gilt auch für NVIDIA-Karten. Installieren Sie keinen Linux-Grafiktreiber in WSL.
Installieren Sie Docker Desktop mit WSL2 und aktivieren Sie Settings → Resources → WSL Integration → Ubuntu-26.04. Verwenden Sie dessen Docker Engine; eine zusätzliche Engine in Ubuntu ist nicht nötig.
Prüfen Sie den Server und den Display-Socket:
docker version --format '{{.Server.Version}}'
test -S /mnt/wslg/.X11-unix/X0
printf '%s\n' "$DISPLAY"
Fehlt der Socket, schließen Sie zunächst die WSLg-Einrichtung ab.
2. POSIM herunterladen
docker pull ioeslab/posim:latest
Versionen und eigene Builds beschreibt die Seite Docker-Umgebung. Die folgende Einrichtung verwendet Software-Rendering. Für unterstützte NVIDIA-GPUs gelten die Voraussetzungen für den GPU-Zugriff.
3. Container erstellen
docker run -d --name posim --init --shm-size=1g \
-e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
--mount type=bind,source=/mnt/wslg/.X11-unix,target=/tmp/.X11-unix,readonly \
--mount type=volume,source=posim-data,target=/work \
--entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'
Speichern Sie eigene Dateien unter /work im Volume posim-data. Mit docker stop posim halten Sie den Container an, mit docker start posim starten Sie ihn wieder.
Öffnen Sie für die weiteren Beispiele zwei Ubuntu-Terminals und verbinden Sie beide mit diesem Container. Gazebo erscheint direkt als Windows-Fenster.
4. Demo-Welt starten
Öffnen Sie eine Sitzung im Container:
docker exec -it posim bash
Prüfen Sie die Installation mit der Demo:
source /opt/ros/lyrical/setup.bash
source /opt/posim_ws/install/setup.bash
ros2 launch posim_demos posim_world.launch.py \
world_name:=posim_ocean_waves headless:=false
Gazebo sollte die Ozeanwelt anzeigen. Lassen Sie das Terminal geöffnet; Strg+C beendet die Simulation. Fahren Sie mit Ihrem ersten Roboter fort.
Starten Sie die Linux-Version von QGC im selben POSIM-Container. Öffnen Sie QGC weder auf dem Windows-Host noch außerhalb des Containers in WSL. Folgen Sie der QGC-Einrichtung.