---
title: Container Registry
description: Store, manage, and deploy private Docker container images using the E2E Container Registry on TIR.
keywords: [container registry, docker, images, push, pull, TIR, E2E Networks]
---

# Container Registry

The E2E Container Registry is a private, secure service for storing and managing Docker container images. It gives you full control over your container assets without relying on public registries like Docker Hub — ideal for production workloads, proprietary models, and team-shared environments.

## Key Concepts

| Term | Description |
|------|-------------|
| **Registry** | A scoped namespace under which your images are organized. Each registry has a unique namespace used in image URLs. |
| **Image** | A versioned, layered container template built from a Dockerfile. An image can have multiple tags. |
| **Artifact / Tag** | A specific version of an image, identified by a tag (e.g., `v1.0`, `latest`). |

## Prerequisites

- An active [E2E Cloud](https://myaccount.e2enetworks.com) account with access to TIR.
- [Docker](https://docs.docker.com/get-docker/) installed on your local machine.

---

## Getting Started

### Step 1: Create a Registry

1. In the TIR sidebar, navigate to **Integrations → E2E Container Registry**.
2. Click **Create E2E Registry**.
3. Fill in the required fields:

   | Field | Description |
   |-------|-------------|
   | **Namespace** | A unique name for your registry (used in image URLs) |
   | **Username Prefix** | A prefix used to generate your login credentials |

4. Click **Create**.

### Step 2: Authenticate with Docker

Use the credentials from your registry details page to log in:

```bash
docker login registry.e2enetworks.net -u <username> -p <password>
```

:::tip
You must authenticate before pushing or pulling images. Run this command once per session.
:::

---

## Push an Image

Once authenticated, push a local Docker image to your registry:

```bash
# 1. List local images to find the one you want to push
docker images

# 2. Tag the image for your registry
docker tag <image>:<tag> registry.e2enetworks.net/<namespace>/<image>:<tag>

# 3. Push the tagged image
docker push registry.e2enetworks.net/<namespace>/<image>:<tag>
```

**Example:**

```bash
docker tag my-app:v1.0 registry.e2enetworks.net/my-namespace/my-app:v1.0
docker push registry.e2enetworks.net/my-namespace/my-app:v1.0
```

## Pull an Image

Pull an image from your registry to any authenticated machine:

```bash
docker pull registry.e2enetworks.net/<namespace>/<image>:<tag>
```

:::info
Ensure you are authenticated with `docker login` before pulling private images.
:::

---

## Managing Resources

### Delete an Artifact (Tag)

Remove a specific tag from an image without deleting the image itself:

1. Click the image name to open its details.
2. Click the **Delete** icon next to the artifact (tag) you want to remove.
3. Confirm the deletion.

### Delete an Image

Remove an entire image and all its associated tags:

1. Click the image name to open its details.
2. Click **Delete Image** and confirm.

:::warning
Deleting an image removes all its tags permanently. Running workloads that reference this image may fail.
:::

### Delete a Registry

Remove a registry and everything stored within it:

1. Click the **Delete** icon next to the registry you want to remove.
2. Confirm the deletion.

:::danger
Deleting a registry permanently removes **all images and artifacts** stored within it. This action cannot be undone.
:::

---

## Quick Reference

| Action | Command |
|--------|---------|
| **Login** | `docker login registry.e2enetworks.net -u <username> -p <password>` |
| **Tag** | `docker tag <image>:<tag> registry.e2enetworks.net/<namespace>/<image>:<tag>` |
| **Push** | `docker push registry.e2enetworks.net/<namespace>/<image>:<tag>` |
| **Pull** | `docker pull registry.e2enetworks.net/<namespace>/<image>:<tag>` |


---