POSIM v1.0.1Platform for Ocean Simulation · Dokumentation
Dokumentationsmenü
POSIM / Erste Schritte

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.