Pulling Images

Once you have your Docker credentials, you can pull container images from the Breakwater registry.

Authenticating with Docker

First, log in to the registry using the credentials from your license page:

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 command is shown on your license credentials page, with the correct registry, vendor, and product names pre-filled.

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

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 username and password are correct
- 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
- Contact your vendor to generate a new token