Windows: WSL y Docker
Docker Desktop ejecuta POSIM y WSLg muestra Gazebo en el escritorio de Windows. Ejecuta los comandos Docker de esta página en la terminal de Ubuntu dentro de WSL.
1. Preparar WSL y los gráficos
Completa los dos primeros pasos de instalación en Windows: instala Ubuntu 26.04 en WSL2 y actualiza WSL y el controlador gráfico de Windows. Esto también se aplica a NVIDIA. No instales un controlador de pantalla de Linux dentro de WSL.
Instala Docker Desktop con WSL2 y activa Settings → Resources → WSL Integration → Ubuntu-26.04. Utiliza su motor Docker; no necesitas instalar otro dentro de Ubuntu.
Comprueba el servidor y la conexión con la pantalla:
docker version --format '{{.Server.Version}}'
test -S /mnt/wslg/.X11-unix/X0
printf '%s\n' "$DISPLAY"
Si falta el socket, termina la configuración de WSLg.
2. Descargar POSIM
docker pull ioeslab/posim:latest
Consulta las versiones y compilaciones en Entorno Docker. Esta configuración utiliza renderizado por software. Para una GPU NVIDIA compatible, revisa los requisitos de acceso a la GPU.
3. Crear el contenedor
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'
Guarda tus archivos en /work, dentro del volumen posim-data. Puedes detener el contenedor con docker stop posim y reanudarlo con docker start posim.
Para los ejemplos siguientes, abre dos terminales de Ubuntu y conecta ambas al mismo contenedor. Las ventanas de Gazebo aparecen directamente en Windows.
4. Ejecutar el mundo de demostración
Entra en el contenedor:
docker exec -it posim bash
Comprueba la instalación ejecutando:
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 debe mostrar el océano. Mantén abierta la terminal; Ctrl+C detiene la simulación. Continúa con tu primer robot.
Ejecuta la versión de Linux de QGC dentro del mismo contenedor POSIM. No abras QGC en el host Windows ni en WSL fuera del contenedor. Sigue la configuración de QGC.