Creating a Docker image

Written by

Updated at August 3, 2026

View in Markdown

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 Dockerfile on your device and add the following lines to it:
```
FROM ubuntu:latest
CMD echo "Hi, I'm inside"
```
The described Docker image is based on Ubuntu and will run 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 specifying a 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.

After you run these commands, a Docker image with the hello tag will appear in your repository. The full repository address will contain:

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

Was the article helpful?

Previous

Getting information about existing Docker images

Next

Pushing a Docker image to a registry