POSIM v1.0.1Platform for Ocean Simulation · Documentazione
Menu della documentazione
POSIM / Per iniziare

Linux: installazione con Docker

Usa l’immagine pubblicata di POSIM se il desktop esegue un’altra versione di Ubuntu o una distribuzione diversa. Questa guida riguarda AMD64 su un computer x86-64, con X11 o XWayland. Su Ubuntu 26.04 consigliamo l’installazione nativa.

1. Preparare Docker e lo schermo

Installa Docker Engine per la tua distribuzione. Per Ubuntu sono disponibili istruzioni dedicate. Se l’account non può eseguire docker, completa la configurazione dopo l’installazione.

Apri un terminale nella sessione desktop e installa xauth. Su Ubuntu:

sudo apt update
sudo apt install -y xauth

Verifica l’indirizzo del display e la versione del server:

printf '%s\n' "$DISPLAY"
docker version --format '{{.Server.Version}}'

2. Scaricare POSIM

docker pull ioeslab/posim:latest

La guida Docker spiega come scegliere una revisione o compilare le proprie modifiche. Il primo avvio usa il rendering software e può essere più lento di un’installazione nativa con GPU.

3. Autorizzare l’accesso al display

Copia l’autorizzazione X11 della sessione in un file leggibile solo dal tuo account:

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"

L’ultimo comando verifica che il file contenga dati. Se fallisce, controlla che il terminale appartenga alla sessione grafica e che XWayland sia disponibile. Risolvi il problema prima di continuare.

4. Creare il container

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'

Salva modelli e registrazioni in /work, nel volume posim-data. Usa docker stop posim e docker start posim per arrestare e riprendere il container. Se il display non funziona dopo un nuovo accesso a Linux, aggiorna il file di autorizzazione.

Per gli esercizi, prepara due terminali collegati allo stesso container. Prima di abilitare accelerazione grafica o sonar CUDA, consulta la configurazione GPU.

5. Avviare il mondo di esempio

Entra nel container:

docker exec -it posim bash

Al suo interno, esegui la verifica finale:

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 deve aprire il mondo oceanico. Lascia il terminale aperto durante l’esecuzione e premi Ctrl+C per fermarla. Prosegui con la prima simulazione.