ibmcloud-cr
Manage IBM Cloud Container Registry
TLDR
Set target region for IBM Cloud Container Registry
List images available
Inspect an image data
Run vulnerability assessment on an image
Log the local Docker or Podman client in to IBM Cloud Container Registry
List all actions available under this command
SYNOPSIS
ibmcloud cr [command] [flags]
PARAMETERS
build
Build container image
image-delete
Delete image(s)
image-inspect
Inspect image(s)
image-list
List image(s)
image-pull
Pull image(s)
image-push
Push image(s)
login
Login to registry
logout
Logout from registry
namespace-add
Add namespace(s)
namespace-delete
Delete namespace(s)
namespace-list
List namespace(s)
plugin-update
Update cr plugin
quota
Show quota usage
region
Show/list regions
repositories
List repositories
va
Vulnerability reports
--api
API endpoint override
--check
Check plugin version
--help, -h
Show help
--locale
Set locale
--output, -o
Output format (json, yaml, table)
--registry
Registry hostname override
--trace
Show trace info
--verbose, -v
Verbose output
DESCRIPTION
The ibmcloud cr command provides a command-line interface to manage container images and namespaces in the IBM Cloud Container Registry (ICR). Part of the IBM Cloud CLI, it requires installing the cr plugin via ibmcloud plugin install cr.
It supports operations like logging in/out, listing/inspecting/pulling/pushing/deleting images, managing namespaces and repositories, checking quotas, building images, and vulnerability assessments. Users must authenticate with an IBM Cloud API key or IAM token.
Ideal for CI/CD pipelines and DevOps workflows on IBM Cloud, it integrates with tools like Docker. Output formats include table, JSON, or YAML for scripting.
CAVEATS
Requires IBM Cloud CLI v0.28+ and cr plugin. Authentication via ibmcloud login and API key mandatory. Regional availability varies; use --registry for multi-region.
INSTALLATION
Run ibmcloud plugin install cr after installing IBM Cloud CLI from ibm.com/cloud/cli.
AUTHENTICATION
ibmcloud login, then ibmcloud cr login with API key for image ops.
HISTORY
Introduced in 2018 with IBM Cloud Container Registry launch. Evolved from Bluemix registry tools; actively maintained by IBM with updates for IAM auth and vulnerability scanning.


