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.