(!) Please ask about problems and questions regarding this tutorial on answers.ros.org. Don't forget to include in your question the link to this page, the versions of your OS & ROS, and also add appropriate tags.

Installing Tiago Tutorial Docker

Description: How to pull and launch a docker all set up for the Tiago Tutorial with melodic or noetic

Tutorial Level: BEGINNER

Next Tutorial: Robots/TIAGo/Tutorials/Installation/Testing_simulation

Author: Job van Dieten < job.1994@gmail.com >, Sai Kishor Kothakota < sai.kishor@pal-robotics.com >

Maintainer: Jordi Pages < jordi.pages@pal-robotics.com >, Thomas Peyrucain < thomas.peyrucain@pal-robotics.com >

Support: tiago-support@pal-robotics.com

Source: https://github.com/pal-robotics/tiago_tutorials.git

  Show EOL distros: 

Docker-based installation

These instructions assume that you have a basic docker understanding and have already installed it. Please familiarize yourself using the docker tutorials.

First of all open a terminal and pull the image of tiago_tutorials:

  • docker pull palroboticssl/tiago_tutorials:melodic

Rocker is mandatory for the following tutorials to have a graphical user interface with docker. osrf/rocker,it is a tool to run docker images with customized local support injected for things like nvidia support, and user_id specific files for cleaner mounting file permissions. You could also find more useful information on this topic on Tooling with Docker.

  • rocker with nvidia support:.

    You would need first to install nvidia docker support : https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker :

  • distribution=$(. /etc/os-release;echo $ID$VERSION_ID)    && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -    && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
    sudo apt-get update
    sudo apt-get install -y nvidia-docker2
    sudo systemctl restart docker
    And then run the rocker
  • rocker --home --user --nvidia --x11 --privileged palroboticssl/tiago_tutorials:melodic
  • rocker with intel integrated graphics support:
  • rocker --home --user --x11 --privileged palroboticssl/tiago_tutorials:melodic --devices /dev/dri/card0

The options --home and --user are used so that the user won't be root and home directory will be mounted

If you are using a version of rocker that is lower than version 0.2.4, you would need to remove the --privileged option

Once you are inside the rocker you can do

  • terminator -u

To open a terminal inside the rocker that will allow you to use several terminals on the same rocker (Do not forget to source them all)

To check that everything is properly installed run the TIAGo simulation tutorial

Docker-based installation

These instructions assume that you have a basic docker understanding and have already installed it. Please familiarize yourself using the docker tutorials.

First of all, open a terminal and pull the image of tiago_tutorials:

  • docker pull palroboticssl/tiago_tutorials:noetic

Rocker is mandatory for the following tutorials to have a graphical user interface with docker. osrf/rocker, it is a tool to run docker images with customized local support injected for things like Nvidia support, and user_id specific files for cleaner mounting file permissions. You could also find more helpful information on this topic on Tooling with Docker.

  • rocker with Nvidia support:

    You would need first to install Nvidia docker support : https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html#docker :

  • distribution=$(. /etc/os-release;echo $ID$VERSION_ID)    && curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -    && curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
    sudo apt-get update
    sudo apt-get install -y nvidia-docker2
    sudo systemctl restart docker
    And then run the rocker
  • rocker --home --user --nvidia --x11 --privileged palroboticssl/tiago_tutorials:noetic
  • rocker with intel-integrated graphics support:
  • rocker --home --user --x11 --privileged palroboticssl/tiago_tutorials:noetic --devices /dev/dri/card0

The options --home and --user are used so that the user won't be root and home directory will be mounted

If you are using a version of rocker that is lower than version 0.2.4, you would need to remove the --privileged option

Once you are inside the rocker you can do

  • terminator -u

To open a terminal inside the rocker that will allow you to use several terminals on the same rocker (Do not forget to source them all)

To check that everything is properly installed run the TIAGo simulation tutorial

Wiki: Robots/TIAGo/Tutorials/Installation/Installing_Tiago_tutorial_docker (last edited 2023-02-21 08:16:35 by thomaspeyrucain)