Linux : installation avec Docker
Utilisez l’image publiée de POSIM si votre bureau fonctionne avec une autre version d’Ubuntu ou une autre distribution. Ce guide concerne AMD64 sur un ordinateur x86-64, avec X11 ou XWayland. Pour Ubuntu 26.04, nous recommandons l’installation native.
1. Préparer Docker et l’affichage
Installez Docker Engine pour votre distribution, ou suivez les instructions Ubuntu. Si votre compte ne peut pas exécuter docker, terminez les étapes après installation.
Ouvrez un terminal dans votre session graphique et installez xauth. Sous Ubuntu :
sudo apt update
sudo apt install -y xauth
Vérifiez l’adresse de l’affichage et la version du serveur :
printf '%s\n' "$DISPLAY"
docker version --format '{{.Server.Version}}'
2. Télécharger POSIM
docker pull ioeslab/posim:latest
Le guide Docker explique comment choisir une révision ou construire vos modifications. Le premier lancement utilise le rendu logiciel, qui peut être plus lent qu’une installation native avec GPU.
3. Autoriser l’accès à votre affichage
Copiez l’autorisation X11 de la session dans un fichier lisible uniquement par votre compte :
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"
La dernière commande vérifie que le fichier n’est pas vide. Si elle échoue, assurez-vous que le terminal appartient à votre session graphique et que XWayland est disponible. Corrigez l’autorisation avant de continuer.
4. Créer le conteneur
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'
Enregistrez vos modèles et acquisitions dans /work, associé au volume posim-data. Utilisez docker stop posim et docker start posim pour arrêter et reprendre le conteneur. Si l’affichage échoue après une nouvelle ouverture de session Linux, actualisez le fichier d’autorisation.
Pour les exercices, préparez deux terminaux reliés à ce même conteneur. Consultez la configuration GPU avant d’activer l’accélération graphique ou le sonar CUDA.
5. Vérifier le monde de démonstration
Entrez dans le conteneur :
docker exec -it posim bash
Exécutez ensuite la vérification finale à l’intérieur :
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 doit ouvrir le monde océanique. Laissez le terminal ouvert pendant l’exécution et arrêtez avec Ctrl+C. Passez ensuite à votre première simulation.