Pulling Images
Once you have a pull token, you can pull container images from the Breakwater registry.
Authenticating with Docker
First, log in to the registry with the username of one of your organization's pull tokens (create one on the Tokens page if you have none). Docker prompts for the token secret:
docker login registry.breakwaterapp.com -u your_username
Pulling an Image
After authenticating, pull images using the standard Docker command:
docker pull registry.breakwaterapp.com/vendor-name/product-name:tag
The exact pull commands are shown on your license credentials page, with the correct registry, vendor, and product names pre-filled. Follow Browse tags to see the tags you can pull; see Browsing Tags and Pull History.
Tag Restrictions
Some licenses restrict which image tags you can access. Common restrictions include:
- Wildcard patterns - e.g.,
v1.*allowsv1.0,v1.2.3, but notv2.0 - Version ranges - e.g.,
>= 2.0, < 3.0allows any 2.x version
Version ranges skip pre-release tags such as 2.1.0-rc.1 unless the range itself names a pre-release. The Browse tags page on your license shows exactly which tags you can pull.
If you try to pull a tag outside your license restrictions, the pull will be denied. Contact your vendor if you need access to additional versions.
Troubleshooting
Authentication failed
- Verify your token username and secret are correct, and that the token is still active on the Tokens page
- Check that your license is still active
- Ensure you're using the correct registry hostname
Pull denied
- Your license may have expired
- The tag may be outside your license's allowed versions
- Contact your vendor for assistance
Credential expired
- Auth tokens can expire over time
- Create a new token on the Tokens page and revoke the expired one