Skip to main content
Registries are the project-owned repositories where MeshAgent stores OCI images for your services. Use them when you want to build, publish, and deploy containerized services inside MeshAgent without depending on a separate registry such as Docker Hub, Azure Container Registry, or Google Artifact Registry. MeshAgent can still work with other registry paths, but project registries give you the MeshAgent-native path when you want image storage and deployment in one place.

How registries work

Each repository belongs to a project and holds the image tags for one service or image family. Tags in the project registry use this shape:
A build may run from your local files or inside one room, but when you publish it to a registry.meshagent.com/... tag, the resulting image lives in the project registry. That means other rooms in the same project can deploy from the same published image tag. The repository namespace belongs to the project, not to one room.

Create a repository

Create a repository when you want a stable image name that you plan to build and publish more than once, such as a service, worker, or app. In most projects, you keep one repository per service or image family, then publish new tags into it over time. Create the repository before pushing tags into it:
bash
The repository name is an OCI-style repository path inside the active project.

Inspect and manage repositories

List repositories in the active project:
bash
Show one repository:
bash
Update the name or description:
bash
Delete a repository:
bash

Use the repository with meshagent build

Once the repository exists, publish images into it with meshagent build:
bash
meshagent build validates that:
  • the project key in the tag matches the selected project
  • the target repository exists in that project
The build can run from your local files or inside a room, but the published image tag points at the project registry repository. If the repository does not exist yet, create it with meshagent registry create first.

Repository token scope

A token issued for a repository grants only the requested pull or push actions on that exact repository. It does not grant access to sibling repositories, nested repositories, or other projects. Users with access to several repositories can request a token for each one. The automatic credential used by meshagent build is scoped to its output repository. If a build pulls a private base image from another repository, it needs a credential explicitly authorized for that source. Adding several credentials for the same registry is insufficient when the runtime selects only the first matching credential. Public base images and images from the selected output repository keep their existing behavior. After deploying this scope restriction, previously issued repository tokens retain their original grants until expiration, at most one hour after issuance. Request a new token to use the narrower scope.