Authenticate to Katapult Container Registry
When using the Katapult Container Registry, you need to authenticate to access your container images. This guide will walk you through the authentication process.
Get an API token
To authenticate to the Katapult Container Registry, you need an API token. You can generate different types of API tokens depending on your needs.
- Organization API token: This token is used to authenticate to the Katapult Container Registry and can be used by all users in your organization. It is useful for CI/CD pipelines or other automated processes.
- User API token: This token is used to authenticate to the Katapult Container Registry and is tied to your user account. It is useful for personal use or when you need to authenticate as a specific user.
Generate a Organization level API token
- Log in to your Katapult account.
- Navigate to the API Tokens section in your account settings.
- Give your token a name.
- Optional: Set Authorized IP Addresses to restrict access to your token.
- Select the scopes you need. For the Container Registry, you will need the
Core: Manage container registries
scope orCore: Read-only access to container registries
if you only need read access. - Click Create API token.
- Copy the generated token and store it securely. You will not be able to see it again.
Generate an individual User API Token
- Log in to your Krystal Identity account.
- Navigate to the Static Access Tokens
- Click Create new static access token
- Give your token a name.
- Select an expiration date for your token.
- Click Create token.
- Copy the generated token and store it securely. You will not be able to see it again.
- Click Manage scopes.
- Select the scopes you need. For the Container Registry, you will need the
Manage container registries
scope orRead-only access to container registries
if you only need read access. - Click Save scopes.
Use the API token
This will be used as your password when authenticating to the Katapult Container Registry. You can use the API token to authenticate to the Katapult Container Registry using Docker or other container tools.
- Docker
- Podman
- Skopeo
- Buildah
- Helm
docker login kcr.io \
--username <your-katapult-email> \
--password <your-api-token>
podman login kcr.io \
--username <your-katapult-email> \
--password <your-api-token>
skopeo login kcr.io \
--username <your-katapult-email> \
--password <your-api-token>
buildah login kcr.io \
--username <your-katapult-email> \
--password <your-api-token>
helm registry login kcr.io \
--username <your-katapult-email> \
--password <your-api-token>