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.* allows v1.0, v1.2.3, but not v2.0
  • Version ranges - e.g., >= 2.0, < 3.0 allows 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

Last updated November 19, 2026