Skip to main content

sekuire registry

Manage OCI registry authentication and push container images for your AI agents.

Subcommands​

login​

Authenticate with the Sekuire OCI registry via Docker login.

sekuire registry login

This uses your existing Sekuire API key (from sekuire login) to authenticate with the container registry.

Options​

OptionDescription
--registry <URL>Registry URL (default: https://registry.sekuire.ai)
--backend <URL>Backend API URL (default: https://api.sekuire.ai)

pull​

Pull a container image from the Sekuire OCI registry. Handles authentication automatically for private images.

sekuire registry pull <IMAGE> [OPTIONS]

Options​

OptionDescription
<IMAGE>Image to pull (e.g., org/myorg/agent:v1 or sekuire_id:tag)
--registry <URL>Registry URL (default: registry.sekuire.ai)
--backend <URL>Backend API URL (default: https://api.sekuire.ai)

Image Naming​

Images follow OCI naming conventions:

registry.sekuire.ai/org/<ORG>/<AGENT>:<TAG>    # Private (org-scoped)
registry.sekuire.ai/<SEKUIRE_ID>:<TAG>          # Public (ID-based)

Example​

Terminal
# Pull private image (auto-authenticates)
$ sekuire registry pull registry.sekuire.ai/org/my-org/my-agent:v1
  Private image detected, authenticating...
  Pulling registry.sekuire.ai/org/my-org/my-agent:v1...
  Pulled registry.sekuire.ai/org/my-org/my-agent:v1

# Pull public image
$ sekuire registry pull registry.sekuire.ai/7f8a9b3c2d1e:latest
  Pulling registry.sekuire.ai/7f8a9b3c2d1e:latest...
  Pulled registry.sekuire.ai/7f8a9b3c2d1e:latest

# Short form (registry prefix added automatically)
$ sekuire registry pull org/my-org/my-agent:v1

Private vs Public​

  • Private images (/org/...): Requires org membership, auto-authenticates
  • Public images: Anyone can pull, no authentication needed

push​

Push a container image to the Sekuire OCI registry.

sekuire registry push <IMAGE> [OPTIONS]

Options​

OptionDescription
<IMAGE>Image reference (e.g., registry.sekuire.ai/org/agent:tag)
--registry <URL>Registry URL (default: https://registry.sekuire.ai)
--backend <URL>Backend API URL (default: https://api.sekuire.ai)

Example​

Build and push
# Build with registry tag
docker build -t registry.sekuire.ai/my-org/my-agent:v1.0.0 .

# Push (authenticates automatically)
sekuire registry push registry.sekuire.ai/my-org/my-agent:v1.0.0

Authentication Flow​

  1. sekuire login - Obtain API key from Sekuire
  2. sekuire registry login - Exchange API key for OCI token
  3. docker login stores credentials in your Docker config

Next Steps​