What Is It?
Private Container Registry is a fully managed, OCI-compliant registry for storing and managing Docker container images and OCI artifacts. The service provides authenticated access over the public internet, optionally limited to listed IP subnets, with encryption at rest, token-based access control, and optional vulnerability scanning. IONOS CLOUD operates the underlying infrastructure with automatic security patches and updates. Supports standard Docker CLI and Docker Registry HTTP API V2 workflows.
Quick Facts
| Aspect | Details |
|---|---|
| Type | Managed OCI-compliant container registry |
| Compliance | OCI (Open Container Initiative) standard |
| Authentication | Token-based; token permissions apply to the whole registry |
| Encryption | Automatic encryption at rest (platform-managed keys) |
| Vulnerability Scanning | Optional add-on (CVE database scanning with CVSS ratings) |
| Location | Frankfurt (de/fra) only; the location cannot be changed after creation |
| Management | DCD, Cloud API, DevOps Tools, Docker CLI |
What You Can Do
Store Container Images
Push Docker images and OCI artifacts to private repositories with authenticated access. Create multiple repositories per registry for logical separation by project, environment, or team.
Token-Based Access Control
Generate permanent or temporary tokens that allow pull, push, delete or repository listing. Token permissions apply to the whole registry; you cannot limit push, pull or delete to a single repository. Configure optional expiry dates and disable tokens as needed without deleting them.
Vulnerability Scanning
Enable optional scanning of every pushed artifact against CVE databases. Receive severity ratings (CVSS 0-10 scale) and searchable results. Images pushed or pulled in the past 30 days are rescanned automatically when new vulnerability information is published.
Note: Scanning cannot be disabled once enabled.
Garbage Collection
Garbage collection is off by default. Turn it on and schedule it weekly in the DCD, or set finer schedules through the API, to clean up unreferenced image layers and free storage. Configure day and time for automatic runs.
Note: Registry is read-only during garbage collection.
Docker CLI Integration
Use standard Docker commands (login, push, pull) with full Docker Registry HTTP API V2 compatibility; delete images with regctl or the API. Integrate seamlessly with CI/CD pipelines without custom adapters.
Multi-Repository Management
Host many separate repositories within a single registry. Organize images by application, microservice, or deployment stage. Note: Fine-grained repository-level access control is not available; token permissions apply at the registry level.
Best For
| Scenario | Why It Fits |
|---|---|
| Kubernetes deployments | Store images for Managed Kubernetes clusters and any Docker Registry HTTP API V2 compliant tool |
| CI/CD pipelines | Integrate with automated build and deployment workflows |
| Microservices architectures | Separate repositories per service in one registry |
| Secure software supply chain | Vulnerability scanning identifies CVEs before deployment |
| Multi-environment deployments | Organize images by dev, staging and production repositories, with a distinct token for each environment |
| Team collaboration | Token-based access control for different roles and permissions |
Consider Alternatives If
| If You Need... | Consider | Why |
|---|---|---|
| Public container image hosting | Docker Hub, GitHub Container Registry | No authentication required for public access |
| Self-hosted registry with full control | Harbor on Compute Engine | Custom configuration and user-managed infrastructure |
| Artifact storage beyond containers | IONOS Cloud Object Storage | General-purpose object storage for any artifact type |
Key Considerations
Billing & Costs
- Main billing: EUR 0.04 per GB of storage per 30 days
- Storage: Based on total image storage consumed
- Vulnerability scanning: Optional add-on (EUR 0.02 per GB per 30 days)
- Data transfer: Network traffic (image push/pull) is not charged
Limitations
- Location immutability: Registry location cannot be changed after creation
- Encryption keys: Platform-managed only (cannot supply customer-managed keys)
- Vulnerability scanning: Cannot be disabled once enabled
- Garbage collection downtime: Registry is read-only during scheduled runs
- No anonymous access: All operations require token authentication
- Rate limits: 60 requests per second and 100 concurrent connections per client
- Single location: Available only in Frankfurt (de/fra)
Management Options
- Data Center Designer (DCD): Create registries, manage repositories, generate tokens, configure garbage collection
- Cloud API: Programmatic access for registry lifecycle, token management, repository deletion and garbage collection schedules
- Docker CLI: Standard docker login, push and pull commands; delete images with
regctlor the API - CI/CD integration: Any pipeline that uses Docker Registry HTTP API V2 compliant tools, authenticated with registry tokens