# Getting started with Cloud Registry

Use this guide to create your first [registry](../concepts/registry.md) and try your hand at managing [Docker images](../concepts/artifacts/docker.md).

## Getting started {#before-you-begin}

To create a registry, you will need a folder in Yandex Cloud. If you do not have any folders yet, create one before creating a registry:

1. In the [management console](https://console.yandex.cloud), in the top panel, click ![image](../../_assets/console-icons/layout-side-content-left.svg) or ![image](../../_assets/console-icons/chevron-down.svg) and select the [cloud](../../resource-manager/concepts/resources-hierarchy.md#cloud).
1. To the right of the cloud name, click ![image](../../_assets/console-icons/ellipsis.svg).
1. Select ![image](../../_assets/console-icons/plus.svg) **Create folder**.

   ![create-folder1](../../_assets/resource-manager/create-folder-1.png)

1. Give your [folder](../../resource-manager/concepts/resources-hierarchy.md#folder) a name. The naming requirements are as follows:

    * Length: between 3 and 63 characters.
    * It can only contain lowercase Latin letters, numbers, and hyphens.
    * It must start with a letter and cannot end with a hyphen.

1. Optionally, specify the description for your folder.
1. Select **Create a default network**. This will create a [network](../../vpc/concepts/network.md#network) with subnets in each availability zone. Within this network, you will also have a [default security group](../../vpc/concepts/security-groups.md#default-security-group), within which all network traffic will be allowed.
1. Click **Create**.

   ![create-folder2](../../_assets/resource-manager/create-folder-2.png)

## Creating a registry and pushing a Docker image {#create-and-push}

To work with Cloud Registry and Docker images:

1. [Install the Yandex Cloud CLI](../../cli/operations/install-cli.md) and [configure](../operations/docker/installation.md) Docker.
1. [Create a registry](../operations/registry/create.md) in Cloud Registry.
1. [Get authenticated](../operations/docker/authentication.md) in Cloud Registry.
1. Pull a Docker image from [Docker Hub](https://hub.docker.com):

   ```bash
   docker pull ubuntu
   ```

1. Assign the pulled Docker image a tag in this format: `registry.yandexcloud.net/<registry_ID>/<Docker_image_name>:<tag>`:

   ```bash
   docker tag ubuntu \
   registry.yandexcloud.net/<registry_ID>/ubuntu:hello
   ```

1. Push the Docker image to the repository Cloud Registry:

   ```bash
   docker push \
   registry.yandexcloud.net/<registry_ID>/ubuntu:hello
   ```

1. Run the Docker image:

   ```bash
   docker run \
   registry.yandexcloud.net/<registry_ID>/ubuntu:hello
   ```

#### See also {#see-also}

[Supported artifact types](../concepts/artifacts/index.md#artifacts)