SUSE Private Registry
Publication Date: 2026-10-30
- Release notes
- Copyright
- 1 Introduction
- 2 Requirements
- 3 Installing SUSE Private Registry using the Rancher UI
- 3.1 What requirements must I meet?
- 3.2 Creating a namespace
- 3.3 Adding the SUSE Private Registry repository
- 3.4 Creating the registry and TLS secrets
- 3.5 Installing the Helm chart
- 3.6 How do I configure Private Registry during the installation?
- 3.7 How do I verify the installation?
- 3.8 Upgrading Private Registry using the Rancher UI
- 3.9 What if the installation fails?
- 4 Installation using the command line
- 5 Installing in air-gapped environment
- 6 High Availability setup
- 6.1 Understanding the HA setup
- 6.2 Choosing a resilience model
- 6.3 Distributing Private Registry components
- 6.4 Providing a highly available endpoint
- 6.5 Prerequisites
- 6.6 Choosing resilient dependencies and storage
- 6.7 Using CloudNativePG with Private Registry
- 6.8 Deploying Private Registry with HA
- 6.9 Performing maintenance and upgrades
- 6.10 Configuring retention and garbage collection
- 6.11 Monitoring the deployment
- 6.12 Managing network traffic
- 6.13 Planning backup and recovery
- 6.14 Reviewing the deployment before production
- 7 Configure Rancher as an OIDC Identity Provider
- 8 How do I automate access to a proxy-cache project?
- 8.1 What do I need before configuring the proxy?
- 8.2 How do I find available components?
- 8.3 How do I create upstream credentials?
- 8.4 How do I configure the registry endpoint and proxy project?
- 8.5 How do I create a pull-only robot account?
- 8.6 How do I replace the dollar sign in robot user names?
- 8.7 How do I pull images and charts through the proxy?
- 8.8 How do I manage registry resources with infrastructure as code?
- 8.9 How do I deploy workloads through the proxy with infrastructure as code?
- 8.10 How do I rotate credentials and troubleshoot access?
- 9 Migrating data from upstream Harbor to SUSE Private Registry
- 10 Backing up and restoring with Velero
- 11 Frequently asked questions
- 12 Troubleshooting
- A Overriding the SUSE Private Registry Helm chart
- B Example of a Private Registry HA setup Helm chart
- C GNU Free Documentation License
- C1 0. PREAMBLE
- C2 1. APPLICABILITY AND DEFINITIONS
- C3 2. VERBATIM COPYING
- C4 3. COPYING IN QUANTITY
- C5 4. MODIFICATIONS
- C6 5. COMBINING DOCUMENTS
- C7 6. COLLECTIONS OF DOCUMENTS
- C8 7. AGGREGATION WITH INDEPENDENT WORKS
- C9 8. TRANSLATION
- C10 9. TERMINATION
- C11 1. FUTURE REVISIONS OF THIS LICENSE
- C12 ADDENDUM: How to use this License for your documents
List of Figures
- 3.1 Adding a SUSE Private Registry repository
- 3.2 Adding SUSE Private Registry secrets
- 3.3 Installing SUSE Private Registry
- 3.4 Setting the ingress values
- 3.5 Editing the chart values as YAML
- 3.6 Installed release
- 6.1 Private Registry HA setup
- 8.1 Application Collection artifact details and available versions
- 8.2 Application Collection registry endpoint form in Harbor
- 8.3 Robot Name Prefix setting in SUSE Private Registry