rtabmap_ros/docker/README.md

### Docker

* Available images on [introlab3it/rtabmap_ros](https://hub.docker.com/r/introlab3it/rtabmap_ros/):
    ```
    indigo
    kinetic
    melodic, melodic-latest
    noetic, noetic-latest
    ```
    * The `-latest` images are automatically built from latest version of `rtabmap` and `rtabmap_ros` from source (including dependencies that are not available with ROS binaries). The other images have the same version than the binaries released on ROS. 


* Launch `rtabmap` from inside the container (**no gui**), saving the database on host `~/.ros/rtabmap.db`:
    ```bash
    docker run -it --rm \
     --user $UID \
     -e ROS_HOME=/tmp \
     --network host \
     -v ~/.ros:/tmp \
     introlab3it/rtabmap_ros:noetic-latest \
     roslaunch --wait rtabmap_launch rtabmap.launch rtabmap_viz:=false database_path:=/tmp/rtabmap.db rtabmap_args:="--delete_db_on_start"
   ```
   
* Launch `rtabmap` from inside the container (**with gui**), saving the database on host `~/.ros/rtabmap.db`, using [nvidia-docker2 approach](http://wiki.ros.org/docker/Tutorials/Hardware%20Acceleration#nvidia-docker2):

    ```bash
    # those following 3 lines would need to be done only one time
    XAUTH=/tmp/.docker.xauth
    touch $XAUTH
    xauth nlist $DISPLAY | sed -e 's/^..../ffff/' | xauth -f $XAUTH nmerge -

    docker run -it --rm \
      --privileged \
      --user $UID \
      -e ROS_HOME=/tmp \
      -e DISPLAY=$DISPLAY \
      -e QT_X11_NO_MITSHM=1 \
      -e NVIDIA_VISIBLE_DEVICES=all \
      -e NVIDIA_DRIVER_CAPABILITIES=all \
      -e XAUTHORITY=$XAUTH \
      --runtime=nvidia \
      --network host \
      -v $XAUTH:$XAUTH \
      -v /tmp/.X11-unix:/tmp/.X11-unix \
      -v ~/.ros:/tmp \
      introlab3it/rtabmap_ros:noetic-latest \
      roslaunch --wait rtabmap_launch rtabmap.launch database_path:=/tmp/rtabmap.db gui_cfg:=/tmp/rtabmap_gui.ini rtabmap_args:="--delete_db_on_start"
    ```