> For the complete documentation index, see [llms.txt](https://docs.vngcloud.vn/vng-cloud-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/container-registry.md).

# Container Registry

GreenNode automatically provisions a private repository in Container Registry for your organization — store container images securely and use them directly when deploying Agent Runtime, with no external registry setup required.

***

## Overview

Container Registry in AgentBase is built on [VNG Cloud Container Registry (vCR)](https://github.com/vngcloud/docs/blob/main/vcontainer-registry/README.md). When your organization is onboarded to AgentBase, a private repository is already created for you — no manual setup needed.

View your organization's image list at: <https://aiplatform.console.vngcloud.vn/container-registry/repository>

![Container Registry — image list](/files/mwfdHsneFLs35kyXnxqY)

**Benefits:**

* Images are not publicly accessible
* Combine with Private VPC for a fully internal deploy pipeline
* Natively integrated when creating a Custom Agent Runtime — no extra configuration needed

***

## Push an Image to the Registry

### Using AgentBase Skills (recommended)

If you have [AgentBase Skills](https://github.com/vngcloud/greennode-agentbase-skills) installed, use the built-in scripts — credentials are handled in-memory and never exposed to the terminal or disk:

**Step 1:** Get your organization's repository info

```bash
bash .claude/skills/agentbase/scripts/cr.sh repo get
```

Returns `registryUrl` (`vcr.vngcloud.vn`) and `name` (your organization's repo name).

**Step 2:** Log in to Docker securely

```bash
bash .claude/skills/agentbase/scripts/cr.sh credentials docker-login
```

**Step 3:** Tag and push your image

```bash
docker tag my-agent:latest vcr.vngcloud.vn/<repoName>/my-agent:v1.0
docker push vcr.vngcloud.vn/<repoName>/my-agent:v1.0
```

### Using Docker CLI manually

**Step 1:** Log in (using credentials from the Portal)

```bash
docker login vcr.vngcloud.vn
```

**Step 2:** Tag your image

```bash
docker tag my-agent:latest vcr.vngcloud.vn/<repoName>/my-agent:v1.0
```

**Step 3:** Push the image

```bash
docker push vcr.vngcloud.vn/<repoName>/my-agent:v1.0
```

***

## Use the Image When Creating a Runtime

**Using AgentBase Skills** — pass the `--from-cr` flag, credentials are fetched automatically:

```bash
bash .claude/skills/agentbase/scripts/runtime.sh create \
  --image "vcr.vngcloud.vn/<repoName>/my-agent:v1.0" \
  --from-cr
```

**Using the Portal** — when creating a Custom Agent Runtime, enter:

* **Image URL:** `vcr.vngcloud.vn/<repoName>/my-agent:v1.0`
* **Registry Auth:** enable → enter robot account username and password

See the full guide at [Create Runtime](/vng-cloud-document/ai-stack/agent-base/agent-runtime/create-runtime.md).

***

## Advanced Management

The Container Registry page in AgentBase is sufficient for pushing and using images with Runtime. For full management (additional repositories, access control policies, image lifecycle rules...) → see [VNG Cloud Container Registry](https://github.com/vngcloud/docs/blob/main/vcontainer-registry/README.md).

***

## Getting Started

| I want to...                                    | Go to                                                                                                    |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Create a Runtime from an image in this registry | [Create Runtime](/vng-cloud-document/ai-stack/agent-base/agent-runtime/create-runtime.md)                |
| Manage Container Registry in full               | [VNG Cloud Container Registry](https://github.com/vngcloud/docs/blob/main/vcontainer-registry/README.md) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/container-registry.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.