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: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
Inspect and manage repositories
List repositories in the active project:bash
bash
bash
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
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 bymeshagent 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.