Netaxis Docker Registry

The following chapter describes the procedure on how to login to the Netaxis Docker Registry in CLI.

The login credentials are different depending on which product you are using. To obtain those credentials, contact Netaxis support via the Support Portal.

What is the Netaxis Docker Registry and what is it for

The Netaxis Docker Registry is the central repository where all Docker images for Netaxis software are stored and maintained.

With this registry, you can:

• Download the latest approved software images
• Perform upgrades and updates independently
• Ensure version consistency across deployments

View currently connected docker registries

Check if the current user is already connected to the Netaxis docker registry, if you have something similar to the results of the command below, you can skip to View list of repositories in a project

cat /home/username/.docker/config.json
{
  "auths": {
    "distribution.bxl.netaxis.be": {}
  },
  "credsStore": "osxkeychain",
  "currentContext": "colima"
}

Login to Netaxis Docker Registry

If the machine is not connected, use the following command :

docker login distribution.bxl.netaxis.be

The command will prompt you for credentials that were shared by your Netaxis contact person.

View list of repositories in a project

The Netaxis Docker Registry is product based, it means that a single account is created per product.

For a single project, using your credentials, you can obtain a list of all the available images that your account has access to on the registry, use the following command :

Assuming our credentials are for for test_repo, we can do

curl -s --user 'robot$test_repo+USERNAME:REDACTED' https://distribution.bxl.netaxis.be/api/v2.0/projects/test_repo/repositories | jq

Where :

• robot$test_repo+USERNAME is the username provided by Netaxis Support
• REDACTED is the password

We get the following answer :

[
  {
    "artifact_count": 20,
    "creation_time": "2026-03-23T14:55:30.352Z",
    "id": 30,
    "name": "test_repo/test_image",
    "project_id": 18,
    "pull_count": 220,
    "update_time": "2026-05-07T11:09:32.564Z"
  }
]

View list of images in a repository

We can obtain a list of all the docker images in a repository we have access to.

If we take the same repository and project as above

Use the following command :

curl -s --user 'robot$test_repo+USERNAME:REDACTED' 'https://distribution.bxl.netaxis.be/v2/test_repo/test_image/tags/list' | jq

We then obtain :

{
  "name": "test_repo/test_image",
  "tags": [
    "1.1.1",
    "1.1.2"
  ]
}

Pulling a docker image from the Docker Registry

After successfully listing the images and finding the image needed, we can simply pull the image with the following command

docker pull distribution.bxl.netaxis.be/test_repo/test_image:1.1.1
1.1.1: Pulling from test_repo/test_image
3dae71ba6b94: Downloading [=========================>                         ]  15.01MB/29.14MB
25e10fd5f85f: Waiting