---
title: "ezgh registry"
description: "Container Registry: repositories, images, docker login and pull-through cache rules."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh registry

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh registry <command>
```

EZGH Container Registry keeps a project's container images on its own registry host, &lt;id&gt;.registry.ezghcloud.com (`ezgh registry get` shows it). Push and pull them with docker or any OCI client at &lt;host&gt;/&lt;scope&gt;/&lt;image&gt;, signing in with an API key (`ezgh registry login`):

```text
ezgh registry login
docker tag api:latest <host>/team-a/api:v1
docker push <host>/team-a/api:v1
```

Everything is in a project (`--project`, `EZGH_PROJECT` or the profile's). A repository is given by ID (rep\_…) or name (team-a/api); an image by digest.

A pull-through cache rule maps a prefix on that host to Docker Hub: the first pull of &lt;host&gt;/&lt;prefix&gt;/&lt;namespace&gt;/&lt;repository&gt; fetches the image with the rule's Docker Hub credentials and stores it in the project, and later pulls are served from that copy.

## Flags

This command also takes the [global flags](/cli/reference#global-flags).

## Subcommands

| Command | Description |
| --- | --- |
| [`ezgh registry cache-rules`](/cli/reference/registry-cache-rules) | Pull-through cache rules: Docker Hub images through your registry |
| [`ezgh registry get`](/cli/reference/registry-get) | Show the project's registry host |
| [`ezgh registry get-login-password`](/cli/reference/registry-get-login-password) | Print the API key to sign a container client in with |
| [`ezgh registry images`](/cli/reference/registry-images) | Images in a repository, by digest |
| [`ezgh registry login`](/cli/reference/registry-login) | Sign docker in to the project's registry |
| [`ezgh registry repositories`](/cli/reference/registry-repositories) | Repositories: where a project's images are pushed and pulled |
| [`ezgh registry tags`](/cli/reference/registry-tags) | Tags in a repository |

Source: https://docs.ezghcloud.com/cli/reference/registry/index.mdx
