Creating a Docker image

Written by

Updated at June 18, 2025

This guide describes how to create and build a Docker image based on a Dockerfile.

To work with Docker images, install and configure Docker.

CLI

Create a file named Dockerfile on your device and add the below lines to it:
```
FROM ubuntu:latest
CMD echo "Hi, I'm inside"
```
The described Docker image is based on Ubuntu and will execute one simple command.
Build the Docker image. For <registry_ID>, use the ID you got when creating the registry.
```
docker build . \
  -t cr.yandex/<registry_ID>/ubuntu:hello
```
The -t flag assigns a URL to the Docker image in this format: cr.yandex/<registry_ID>/<Docker_image_name>:<tag>. You can build Docker images without any tag. In this case, the Docker CLI will provide the default label: latest.

The Docker image name and tag are part of the repository name, which is a URI, and must follow a specific format. For more information, see the OCI Distribution Specification.

Once these commands are executed, a Docker image will be created in your repository with the hello tag and the full address of the repository, which includes:

Container Registry address: cr.yandex.
Your registry ID: <registry_ID>.
Name of your repository: ubuntu.

Creating a Docker image

Was the article helpful?