Linux: instalación con Docker
Usa la imagen publicada de POSIM si tu escritorio tiene otra versión de Ubuntu o una distribución diferente. Esta guía utiliza AMD64 en un equipo x86-64, con X11 o XWayland. En Ubuntu 26.04 recomendamos la instalación nativa.
1. Preparar Docker y la pantalla
Instala Docker Engine para tu distribución; en Ubuntu, sigue estos pasos. Si tu usuario no puede ejecutar docker, completa la configuración posterior a la instalación.
Abre una terminal en tu sesión de escritorio e instala xauth. En Ubuntu:
sudo apt update
sudo apt install -y xauth
Comprueba la dirección de la pantalla y la versión del servidor:
printf '%s\n' "$DISPLAY"
docker version --format '{{.Server.Version}}'
2. Descargar POSIM
docker pull ioeslab/posim:latest
Consulta Docker para elegir una revisión o compilar tus cambios. La primera ejecución utiliza renderizado por software y puede ser más lenta que una instalación nativa con GPU.
3. Autorizar el acceso a tu pantalla
Copia la autorización X11 de esta sesión a un archivo que solo pueda leer tu usuario:
mkdir -p "$HOME/.cache/posim"
export POSIM_XAUTH="$HOME/.cache/posim/xauthority"
touch "$POSIM_XAUTH"
chmod 600 "$POSIM_XAUTH"
xauth nlist "$DISPLAY" | sed -e 's/^..../ffff/' | xauth -f "$POSIM_XAUTH" nmerge -
test -s "$POSIM_XAUTH"
El último comando comprueba que el archivo contiene datos. Si falla, verifica que la terminal pertenece a tu sesión gráfica y que XWayland está disponible. Corrige la autorización antes de continuar.
4. Crear el contenedor
docker run -d --name posim --init --shm-size=1g \
-e DISPLAY -e QT_QPA_PLATFORM=xcb -e LIBGL_ALWAYS_SOFTWARE=1 \
-e XAUTHORITY=/tmp/posim.xauth \
--mount type=bind,source=/tmp/.X11-unix,target=/tmp/.X11-unix,readonly \
--mount "type=bind,source=$POSIM_XAUTH,target=/tmp/posim.xauth,readonly" \
--mount type=volume,source=posim-data,target=/work \
--entrypoint bash ioeslab/posim:latest -lc 'exec sleep infinity'
Guarda tus modelos y grabaciones en /work, dentro del volumen posim-data. Para detener y reanudar el contenedor, utiliza docker stop posim y docker start posim. Si la pantalla deja de funcionar después de volver a iniciar sesión en Linux, actualiza el archivo de autorización.
Para los ejercicios, prepara dos terminales conectadas a este mismo contenedor. Antes de activar aceleración gráfica o sonar CUDA, revisa la configuración de GPU.
5. Comprobar el mundo de demostración
Entra en el contenedor:
docker exec -it posim bash
Ejecuta dentro de él la comprobación final:
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 abrir el mundo oceánico. Mantén la terminal abierta mientras funciona y pulsa Ctrl+C para detenerlo. Continúa con tu primera simulación.