Search by Tags

Writing Your First Dockerfile


Your progress



Up to this point, you have been running pre-existing images from Docker Hub, built by Toradex or other third-party. But it is possible to create your own Docker image to load whatever application you wish. To fulfill this goal, the Dockerfiles exist.

In this section, you will:

  • Write a Dockerfile.
  • Build a Docker image from the Dockerfile.
  • Upload the image to Docker Hub.
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.).

For this lesson:

  • Docker downloaded and running. If you are not sure, please refer to the previous lessons.

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

In your Linux machine, create a new folder named getting-started on the Desktop and a new file named Dockerfile inside it. Copy the following content into the newly created file:

Note: a standard Dockerfile has no extension, therefore make sure your file is not named Dockerfile.txt, especially since file extensions are hidden by default. Consult this lesson's FAQ for details about naming.

FROM torizon/arm32v7-debian-base RUN apt update && apt install nano -y

Note: If you wish, modify the Dockerfile to include more commands, such as RUN apt install python.

Step 2

Open Powershell, login to Docker CLI:

docker login

Follow the prompt with your Docker Hub credentials.

Step 3

Enter your getting-started folder and build the image:

docker build -t <username>/gs-torizon .

Note that this username is your Docker username.

Step 4

Upload the image to your Docker Hub:

docker push <username>/gs-torizon


What is a Dockerfile?
What does the created Dockerfile do?
Can I have multiple Dockerfiles with different names?