POSIM v1.0.1Platform for Ocean Simulation · Documentación
Menú de documentación
POSIM / Primeros pasos

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.