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