Container Registry
Publish Open Container Initiative compliant images for your user or organization. The container registry follows the OCI specs and supports all compatible images like Docker and Helm Charts.
Requirements
To work with the Container registry, you can use the tools for your specific image type.
The following examples use the docker
client.
Login to the container registry
To push an image or if the image is in a private registry, you have to authenticate:
docker login forgejo.example.com
If you are using 2FA or OAuth use a personal access token instead of the password.
Image naming convention
Images must follow this naming convention:
{registry}/{owner}/{image}
For example, these are all valid image names for the owner testuser
:
forgejo.example.com/testuser/myimage
forgejo.example.com/testuser/my-image
forgejo.example.com/testuser/my/image
NOTE: The registry only supports case-insensitive tag names. So image:tag
and image:Tag
get treated as the same image and tag.
Push an image
Push an image by executing the following command:
docker push forgejo.example.com/{owner}/{image}:{tag}
Parameter | Description |
---|---|
owner | The owner of the image. |
image | The name of the image. |
tag | The tag of the image. |
For example:
docker push forgejo.example.com/testuser/myimage:latest
Pull an image
Pull an image by executing the following command:
docker pull forgejo.example.com/{owner}/{image}:{tag}
Parameter | Description |
---|---|
owner | The owner of the image. |
image | The name of the image. |
tag | The tag of the image. |
For example:
docker pull forgejo.example.com/testuser/myimage:latest