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:
For this Quickstart Guide:
Note: Carefully read this module's cover page by clicking on "Module 2: First Steps with Torizon" on the left menu bar before starting this lesson.
Head to the Docker Hub website and create an account.
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.
As mentioned in Docker's documentation, it is possible 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.
On your computer terminal, execute:
$ docker --version
This lets you check whether the installation was successful or not.
Enable Arm emulation in your PC:
$ docker run --rm -it --privileged torizon/binfmt
Warning: This operation will run a privileged container, it will run for the time required to enable Arm emulation using binfmt. It should be a safe operation. Note: Enabling Arm emulation through this method is NOT persistent. After reboots, you have to run this command again to re-enable Arm emulation.
Note: This container will enable binfmt_misc on your Linux machine, which allows you to seamlessly run arm32v7
and arm64v8
binaries on your PC. This is necessary in order to cross-build containers for architectures other than x86 (your development PC). To read more about binfmt_misc, visit the Kernel Documentation.
Make sure you can run the hello-world image on your Linux PC before going to the next lessons:
$ docker run hello-world