Skip to main content
Skip table of contents

Register a new Image Hub

Docker Hub

XNAT will, by default, attempt to pull images from the public Docker Hub with no authentication. If you need to pull private images, or you need to pull from a non-default Hub, you can configure those details by adding a new Hub to the list your XNAT knows. 

Adding a new Image Hub

The Container Service can support multiple image hubs. To add a new one, go to Plugin Settings > Container Service and click on the Compute Backend tab. Then look for the Image Hosts panel. 

Click on New Image Host to configure a new hub to pull from. You will get a dialog with the following settings: 

Image Host Name

A custom label that identifies this image hub within your XNAT, i.e. "My Local Hub"

URL

Enter the full URL path to a queryable image hub, including the http/s protocol  

Username

Optional: If your image hub requires authentication, enter your username here

Access Token / Password

Optional: If your image hub requires authentication, enter your password or access token here.

We strongly encourage using access tokens or a single-use app password rather than storing sensitive user credentials here

Make Default

If set, this new hub will be the default option when pulling new images

Selecting an Image Hub when Pulling Images

If you have more than one image hub configured when installing new container images in your XNAT, you will be asked to choose which image hub to pull from. The default hub will always be listed first. 

See: Adding a Command

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.