crane Verified current stable Not installed? Containers

Crane / List Catalog Repositories In Registry

List Catalog Repositories In Registry

Enumerate all repositories within a specified container registry.

$
Terminal
crane catalog <registry_address>

When To Use

During audits of repository contents for security and compliance validation.

Pro Tip

Use `--filter` to limit results to specific namespaces and improve query performance, especially in large registries.

Command Builder

Tune the command before you copy it

Back to syntax
$
Generated Command
crane catalog <registry_address>

Terminal Output

Expected runtime feedback

Simulated preview
>
Output
+-----------------------------------+
|           Repositories            |
+-----------------------------------+
| my-app-repo                       |
| second-app-repo                   |
| test-repo                         |
| another-repo                      |
+-----------------------------------+

Anatomy of Output

Understanding the result

Repositories available: 10 Repository Count

Total number of repositories detected in the registry.

List of repositories: {repo1, repo2, repo3,...} Repository Names

Shows names of repositories available in the mentioned registry.

Query duration: 120ms Query Performance

Indicates how long the registry query took.

Troubleshooting

Common pitfalls

Error: Unable to connect to registry.

Solution: Check network configuration for registry address access.

Error: Invalid registry address format.

Solution: Ensure the address follows valid URI format.

Error: Authentication failed for registry.

Solution: Revalidate credentials for registry access.

Command Breakdown

What each part is doing

crane
Base Command
The executable that performs this operation. Here it runs Crane before the shell applies any redirect operators.
<registry_address>
registry address
The value supplied for registry address.

How To Run

Execution path

  1. Step 1

    Run the command: `crane catalog my.registry.com` to list repositories.

  2. Step 2

    Verify the output by checking the names of the available repositories in the list.

Alternative Approaches

Comparable commands in other tools

Alternative containers tools for the same job.