Skip to main content
Retrieve detailed information about specific registries by searching with a name or identifier. This command supports filtering and pagination.

​
Usage

hc registry get [name] [flags]

​
Arguments

​
name
string
Registry name or search term (optional). If provided, searches for registries matching this term.

​
Options

​
--package-type
string
Filter registries by package type (DOCKER, NPM, MAVEN, etc.)
​
--page-size
int
default:"10"
Number of items per page
​
--page
int
default:"0"
Page number (zero-indexed)

​
Examples

​
Get All Registries

Without arguments, lists all registries (same as hc registry list): 
hc registry get

​
Search by Name

Find registries matching a search term: 
hc registry get my-docker-reg
Search for registries containing “npm”: 
hc registry get npm
Search for production registries: 
hc registry get prod

​
Combine Search and Filters

Search for Docker registries containing “prod”: 
hc registry get prod --package-type DOCKER
Search for NPM registries with custom pagination: 
hc registry get frontend --package-type NPM --page-size 20

​
Get Specific Registry Details

hc registry get my-docker-registry

​
JSON Output

hc registry get my-docker-registry --format json

​
Output

The command displays detailed information in a table:
ColumnDescription
RegistryRegistry identifier
Package TypeType of packages stored
SizeTotal size of registry content
Registry TypeType (VIRTUAL, LOCAL, REMOTE, etc.)
DescriptionRegistry description
LinkURL to the registry

​
Example Output

$ hc registry get docker

Registry            Package Type  Size        Registry Type  Description
my-docker-reg       DOCKER        1.2 GB      VIRTUAL        Production Docker registry
docker-remote       DOCKER        3.4 GB      REMOTE         Remote Docker Hub proxy
docker-local        DOCKER        890 MB      LOCAL          Local Docker images

Page 1 of 1 (Total: 3 registries)

​
Search Behavior

The search term matches against:
  • Registry identifier
  • Registry name
  • Registry description
The search is case-insensitive and performs partial matching: 
# All of these would match "my-docker-registry"
hc registry get docker
hc registry get my-docker
hc registry get registry
hc registry get DOCKER

​
Filtering by Package Type

Combine search with package type filters: 
hc registry get prod --package-type DOCKER

​
Pagination

Control pagination when search returns many results: 
# Get 25 results per page
hc registry get docker --page-size 25

# Get second page
hc registry get docker --page-size 20 --page 1
Page numbers are zero-indexed. The first page is --page 0, the second page is --page 1, etc.

​
Use Cases

​
Verify Registry Exists

Check if a specific registry exists before using it: 
hc registry get my-registry-name

​
Find Registries by Type

Locate all NPM registries in your account: 
hc registry get --package-type NPM

​
Search Production Registries

Find all production registries: 
hc registry get prod

​
Inspect Registry Size

Check the size of registries to identify large ones: 
hc registry get --page-size 50 | sort -k3 -h

​
Context

The command searches within your current authentication context. To search in a different context: 
hc registry get my-registry --account my-account --org my-org --project my-project

Build docs developers (and LLMs) love

Get started for freeTalk to us