Use a private image repository with Apigee hybrid
This document explains how to configure Apigee hybrid to use images from a private container image repository.
Overview
All Apigee hybrid runtime images are hosted in theArtifact Registry (AR). If for any reason you wish to employ a private image container repository, you can download the images from AR, push them to your private repository. Instead of overriding each component, you can add hub details on the overrides:
Configuration steps
Set the value of thehub configuration property with path to your private repository.
hub:PRIVATE_REPO
For example, if the following hub is provided, it will automatically resolve the image path:
hub:private-docker-host.example.com
as:
## an example of internal component vs 3rd partycontainers:- name: apigee-udca image: private-docker-host.example.com/apigee-udca:1.15.1 imagePullPolicy: IfNotPresentcontainers:- name: apigee-ingressgateway image: private-docker-host.example.com/apigee-asm-ingress:1.22.6-asm.2-distroless imagePullPolicy: IfNotPresent
Click to expand a list of Apigee images
apigee:gcr.io/apigee-release/hybrid/apigee-mart-server:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-synchronizer:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-runtime:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-hybrid-cassandra-client:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-hybrid-cassandra:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-udca:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-connect-agent:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-watcher:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-operators:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-redis:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-mint-task-scheduler:YOUR_HYBRID_VERSION_TAGthirdparty:gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-prom-prometheus:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-stackdriver-prometheus-sidecar:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-envoy:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-prometheus-adapter:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-asm-ingress:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-asm-istiod:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-fluent-bit:YOUR_HYBRID_VERSION_TAGgcr.io/apigee-release/hybrid/apigee-open-telemetry-collector:YOUR_HYBRID_VERSION_TAG
You can see the original version tag of third-party images as a label returned by thedocker history ordocker inspect commands.
To display a list of the Apigee images hosted in the Google Cloud repository use theapigee-pull-push command:
./apigee-operator/etc/tools/apigee-pull-push.sh --list
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.