To develop applications for Torizon, you need to have some prerequisites installed in your development PC. That means installing Docker and enabling Arm emulation. See more information on Configure Build Environment for Torizon Containers.

In this section, you will:

Install the Windows Subsystem for Linux (WSL2)
Install Docker and enable Arm emulation on your PC.
Verify if Docker is correctly installed on your PC.
Get used to Docker's official documentation.

Typographic Conventions

Throughout the Torizon documentation, the following typographic conventions are used:

$ (dollar sign) Command in the host computer (e.g. your PC)

$ Command in your PC

$$ (double dollar sign) Command in a container in the host computer (e.g. your PC)

$$ Command inside a container in your PC

# (hashtag) Command in the target device/board (e.g. Linux terminal)

# Command in the target board, e.g. Colibri iMX6

## (double hashtag) Command inside a container in the target device (Torizon)

## Command inside a container in Torizon

> (greater-than sign) Command in the bootloader (e.g. U-Boot console)

> Command in the Bootloader

No symbol: Command output

$ Command waiting for output
Output

Prerequisites

For this Quickstart Guide:

Development computer with Ubuntu 18.04 LTS.
- Commands and instructions may vary slightly on other Ubuntu releases and Linux distributions.
Successfully completed the previous lessons from this guide.

Note: Carefully read this module's cover page clicking on "Module 2: First Steps with Torizon" on the left menu bar before starting this lesson.

Step 1

Please refer to the Install the Windows Subsystem for Linux (WSL2) section.

Step 2

Head to the Docker Hub website and create an account.

Step 3

You need to install Docker on the host machine to be able to synchronize with your Docker Hub account on the next lessons.

To install Docker follow the instructions on the Official Docker Page.

Step 4

On your computer terminal, execute:

$ docker --version

This lets you check whether the installation was successful or not.

Step 5

Enable Arm emulation in your PC:

$ docker run --rm -it --privileged torizon/binfmt

Warning: This operation will run a privileged container, this will run for the time required to enable Arm emulation using binfmt. It should be a safe operation.

Step 6

Make sure you can run the hello-world image in your Linux PC before going to the next lessons:

$ docker run hello-world

Step 7

As mentioned in Docker's documentation, you will need to add your user to the docker group to avoid needing root privileges.

Before you proceed, it is recommended checking your OS username:

$ whoami

Use the addgroup command:

$ sudo addgroup <your username> docker

Warning: You need to log-out and log-in to the Linux sessing (or reboot machine) after the commands above for the changes take effect.

FAQ

Is the hello-world image the same as the one used on the last module?

Are you having problems with Docker?

Back

Back to Overview