Using Docker with RepoForge.io
RepoForge.io allows you to host private Docker images, making it easy to manage and distribute containerized applications securely. This guide will walk you through the steps to create a Docker registry in RepoForge.io, push images, and manage access.
Creating a Docker registry in RepoForge.io
Before you can push Docker images to RepoForge.io, you need to create a Docker registry via the RepoForge.io dashboard. Follow these steps:
- Log in to your RepoForge.io dashboard.
- Select Docker in the side menu.
- Click New registry.
- Give your registry a name (it must be a valid Docker registry name - lowercase letters, numbers and hyphens, starting with a letter) and click Create registry.

Once the registry is created it appears in the list, along with the unique URI that you'll use to log in and push images to it:

Building and pushing Docker images to RepoForge.io
After setting up your Docker registry, you can build and push Docker images to it using the following commands. Open your registry and click Push package to see these commands with your own registry URI filled in.

- Log in to your RepoForge.io Docker registry:
Use the Docker CLI to log in to your newly created registry. You can authenticate using either your RepoForge.io username and password or an access token with the appropriate role. We recommend an access token: use __token__ as the username and the token as the password.
docker login docker.repoforge.io/repoforge-hash-id/name-of-registry -u __token__Whether you use user credentials or an access token, you must have assumed the Docker - Full access role to push new/updated docker images, or the Docker - Read only role to pull images.
- Build your Docker image:
Build your Docker image using the standard docker build command.
docker build -t name-of-registry .- Tag your Docker image:
After building the image, you need to tag it with the full path to your RepoForge.io registry, including the registry URL and image name:
docker tag name-of-registry docker.repoforge.io/repoforge-hash-id/name-of-registry:latest- Push your Docker image to RepoForge.io:
Finally, push the tagged image to your RepoForge.io Docker registry:
docker push docker.repoforge.io/repoforge-hash-id/name-of-registry:latestYour image will now be stored in your RepoForge.io Docker registry. If you refresh your dashboard in a web browser, you should now be able to see each pushed tag listed under the registry you just created.

Pulling Docker images from RepoForge.io
To pull images from your RepoForge.io Docker registry, ensure that you are logged in with credentials that have either the Docker - Full access or Docker - Read only role.
Log in as you did above (assuming you haven't already done so)
docker login docker.repoforge.io/repoforge-hash-id/name-of-registry -u __token__Pull your docker image:
docker pull docker.repoforge.io/repoforge-hash-id/name-of-registry:latestFurther note about authentication
It's also possible to pull docker images without auth by making them public, or control access more strictly by enabling registry-level permissions. Refer to Authentication and permissions for more information.
For the container registry standards the registry complies with, see Docker registry standards.