App Registries

App Registries enable you to connect to package registries like Docker Hub, GitHub Container Registry, and other repositories for your application dependencies.

What are Registries?

A registry is a storage location for container images or packages. Examples include:

• Docker Hub - For container images
• GitHub Container Registry (GHCR) - For GitHub users
• npm Registry - For Node.js packages
• Maven Central - For Java packages
• PyPI - For Python packages

Adding a Registry

1. Go to Registries in the navigation menu
2. Click on Add Registry
3. Fill in the following information:
   • Name - A recognizable name for the registry (e.g., “Docker Hub - Production”)
   • Type - Select the registry type (Docker, npm, Maven, NuGet, PyPI)
   • URL - The URL to the registry (e.g., https://hub.docker.com)
4. Click on Create

The registry is added to your list and appears with a colored icon based on the type.

Managing Registries

Viewing Registry Information

On the registries page, you see all your registries in a card view:

• Registry name and type
• URL to the registry
• Type badge for quick recognition

Editing a Registry

1. Click on the Edit button on a registry card
2. Change the name, type or URL
3. Click on Update to save the changes

Deleting a Registry

1. Click on the Delete button on a registry card
2. Confirm the deletion

Warning: If you delete a registry that is being used by applications or projects, deployments may fail.

Registry Types

Hydra Deploy supports the following registry types:

Registry Colors

Each registry type has its own color for quick visual identification in the interface:

• npm - Red
• NuGet - Blue to Purple
• Docker - Blue
• Maven - Orange to Red
• PyPI - Yellow

Other registry types are shown with the default main color.

Registry Organization

Organizing Registries

• Give each registry a clear, descriptive name
• Use different registries for different environments if needed
• Keep track of which registry is used by which applications

Security

• Only add registries that you trust
• Use private registries for sensitive packages
• Remove unused registries regularly

Common Use Cases

Docker Hub for Containers

If you deploy containerized applications, add Docker Hub:

1. Choose type: Docker
2. URL: https://hub.docker.com
3. Name: Docker Hub

Private Registry

For a private registry:

1. Choose the appropriate type
2. Add the URL of your private registry
3. Use a descriptive name (e.g., “Company Private Registry”)

Multiple Registries

If you use both open source and private packages, add all necessary registries:

• Docker Hub (open source images)
• GitHub Container Registry (own images)
• Maven Central (Java dependencies)

Best Practices

Registry Usage

• Use clear, descriptive names
• Test registry access before using it in production
• Keep the registry list up to date

Security

• Only add registries that you trust
• Use private registries for sensitive packages
• Remove unused registries

Organization

• Group related registries logically
• Use consistent naming conventions
• Document which registry is used by which applications