Search by Tags

Deploy to the Target


Your progress



In this section, you will:

  • Pull the generated image from Docker Hub
  • Run the image on the device
Typographic Conventions


For this Getting Started Guide:

  • Successfully completed the previous lesson from this guide.
  • Linux Machine (We tested this guide on Ubuntu 18.04 LTS. However, it can work on other distributions.).

Note: Carefully read this module's cover page clicking on "Module 3: Creating my Own Container" on the left menu bar before starting this lesson.

Step 1

On the board, make sure there are no running containers:

docker stop $(docker ps -a -q)

Step 2

Run the image you just uploaded to Docker Hub:

docker run --rm -it -v /var/run/dbus:/var/run/dbus -v /dev:/dev <username>/gs-torizon

This command pulls the image from Docker Hub and runs a new container from it. Since the base image is the Debian ease-of-use container, the same desktop environment from previous lessons starts on the monitor.

It's important to remember that the container will be running in the background, you need to attach it:

# docker ps -a

  • Listing containers

    Listing containers

After listing them, take note of the container ID just like in the image above.

Step 3

On the PuTTy application, attach the container using the ID:

# docker attach "id"

Check that the package we installed in the Dockerfile is available:


  • Customized Docker image

    Customized Docker image


How do I access the container shell from SSH?