Skip to main content

Reference Architectures

Overview​

Run the control plane in a management network and connect it to each data plane over private HTTPS. Corporate operators use the control-plane endpoint. Applications use their regional inference endpoint.

The control plane uses dedicated PostgreSQL and Redis for runtime configuration. Each data plane keeps its own stores.

See Configuration for service settings. Use the cloud deployment guides for each data plane's replicas, availability zones, and model-provider connections.

For OIDC token exchange, allow outbound HTTPS to the IdP from the control plane and each data plane. The control plane exchanges tokens. Each data plane fetches the IdP's signing keys and validates the exchanged token with its own JWT configuration.

AWS​

AWS: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
AWS: Global Control PlaneCorporate administrators reach one control plane through private ingress in us-east-1. The control plane sends management requests over Inter-Region VPC peering to independent LiteLLM dataplanes in us-east-2 and eu-west-1. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and both dataplanes share one AWS account.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · VPN / Direct ConnectAdmins / automationApplications: region AApplications: region BAWS accountus-east-1Management VPCPrivate subnetsControl-plane data subnetsOutbound HTTPSus-east-2Dataplane A VPCPrivate EKS subnetPrivate ingressPrivate data subnetseu-west-1Dataplane B VPCPrivate EKS subnetPrivate ingressPrivate data subnetsManagement HTTPS 443Inter-Region VPC peeringPostgreSQLRuntime configRedisConfig streamLiteLLM dataplaneEKSInternal ALBsLLM / mgmtAurora PostgreSQLElastiCacheRedisLiteLLM dataplaneEKSInternal ALBsLLM / mgmtAurora PostgreSQLElastiCacheRedisControl planeEKS · replicasInternal ALBHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)
AWS: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
AWS: Global Control PlaneCorporate administrators reach one control plane through private ingress in us-east-1. The control plane sends management requests over Inter-Region VPC peering to independent LiteLLM dataplanes in us-east-2 and eu-west-1. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and both dataplanes share one AWS account.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · VPN / Direct ConnectAdmins / automationApplications: region AApplications: region BAWS accountus-east-1Management VPCPrivate subnetsControl-plane data subnetsOutbound HTTPSus-east-2Dataplane A VPCPrivate EKS subnetPrivate ingressPrivate data subnetseu-west-1Dataplane B VPCPrivate EKS subnetPrivate ingressPrivate data subnetsManagement HTTPS 443Inter-Region VPC peeringPostgreSQLRuntime configRedisConfig streamLiteLLM dataplaneEKSInternal ALBsLLM / mgmtAurora PostgreSQLElastiCacheRedisLiteLLM dataplaneEKSInternal ALBsLLM / mgmtAurora PostgreSQLElastiCacheRedisControl planeEKS · replicasInternal ALBHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)

Use inter-Region VPC peering for management traffic. Add both sides' routes and security-group rules. Peering is not transitive, so provide corporate connectivity to each required network separately. See peering routes and limits.

Azure​

Azure: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
Azure: Global Control PlaneCorporate administrators reach one control plane through private ingress in East US. The control plane sends management requests over Global VNet peering to independent LiteLLM dataplanes in Central US and West Europe. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and both dataplanes share one Azure subscription.Managed PostgreSQL and Redis sit outside the deployment VNet and connect through private endpoints.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · VPN / ExpressRouteAdmins / automationApplications: region AApplications: region BAzure subscriptionEast USManagement VNetPrivate subnetsControl-plane storesOutbound HTTPSCentral USDataplane A VNetPrivate AKS subnetGateway subnetWest EuropeDataplane B VNetPrivate AKS subnetGateway subnetManagement HTTPS 443Global VNet peeringPrivate endpointsPostgreSQLRuntime configRedisConfig streamLiteLLM dataplaneAKSApp GatewaysLLM / mgmtPrivate endpointsPostgreSQLFlexible ServerManaged RedisLiteLLM dataplaneAKSApp GatewaysLLM / mgmtPrivate endpointsPostgreSQLFlexible ServerManaged RedisControl planeAKS · replicasApp GatewayHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)
Azure: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
Azure: Global Control PlaneCorporate administrators reach one control plane through private ingress in East US. The control plane sends management requests over Global VNet peering to independent LiteLLM dataplanes in Central US and West Europe. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and both dataplanes share one Azure subscription.Managed PostgreSQL and Redis sit outside the deployment VNet and connect through private endpoints.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · VPN / ExpressRouteAdmins / automationApplications: region AApplications: region BAzure subscriptionEast USManagement VNetPrivate subnetsControl-plane storesOutbound HTTPSCentral USDataplane A VNetPrivate AKS subnetGateway subnetWest EuropeDataplane B VNetPrivate AKS subnetGateway subnetManagement HTTPS 443Global VNet peeringPrivate endpointsPostgreSQLRuntime configRedisConfig streamLiteLLM dataplaneAKSApp GatewaysLLM / mgmtPrivate endpointsPostgreSQLFlexible ServerManaged RedisLiteLLM dataplaneAKSApp GatewaysLLM / mgmtPrivate endpointsPostgreSQLFlexible ServerManaged RedisControl planeAKS · replicasApp GatewayHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)

Use an Application Gateway v2 private deployment with private listeners. Global VNet peering connects the regional networks. Configure private DNS resolution across the peered networks.

GCP​

Google Cloud: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
Google Cloud: Global Control PlaneCorporate administrators reach one control plane through private ingress in us-central1. The control plane sends management requests over VPC Network Peering to independent LiteLLM dataplanes in us-east4 and europe-west1. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and both dataplanes share one Google Cloud project.The project contains separate global VPCs with regional private, frontend, and proxy-only subnets. Data services use private service connections outside the deployment VPC.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · Cloud VPN / InterconnectAdmins / automationApplications: region AApplications: region BGoogle Cloud projectManagement VPC (global)us-central1Private + proxy-only subnetsCP stores · us-central1Outbound HTTPSDataplane A VPC (global)us-east4Private GKEsubnetProxy-onlysubnetFrontendsubnetManaged services · us-east4Dataplane B VPC (global)europe-west1Private GKEsubnetProxy-onlysubnetFrontendsubnetManaged services · europe-west1Management HTTPS 443VPC Network PeeringPostgreSQLRuntime configRedisConfig streamPrivate Services AccessLiteLLM dataplaneGKEInternal ALBsLLM / mgmtLB proxiesCloud SQLPostgreSQLMemorystoreRedisPrivate Services AccessLiteLLM dataplaneGKEInternal ALBsLLM / mgmtLB proxiesCloud SQLPostgreSQLMemorystoreRedisPrivate Services AccessControl planeGKE · replicasInternal ALBHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)
Google Cloud: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
Google Cloud: Global Control PlaneCorporate administrators reach one control plane through private ingress in us-central1. The control plane sends management requests over VPC Network Peering to independent LiteLLM dataplanes in us-east4 and europe-west1. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and both dataplanes share one Google Cloud project.The project contains separate global VPCs with regional private, frontend, and proxy-only subnets. Data services use private service connections outside the deployment VPC.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · Cloud VPN / InterconnectAdmins / automationApplications: region AApplications: region BGoogle Cloud projectManagement VPC (global)us-central1Private + proxy-only subnetsCP stores · us-central1Outbound HTTPSDataplane A VPC (global)us-east4Private GKEsubnetProxy-onlysubnetFrontendsubnetManaged services · us-east4Dataplane B VPC (global)europe-west1Private GKEsubnetProxy-onlysubnetFrontendsubnetManaged services · europe-west1Management HTTPS 443VPC Network PeeringPostgreSQLRuntime configRedisConfig streamPrivate Services AccessLiteLLM dataplaneGKEInternal ALBsLLM / mgmtLB proxiesCloud SQLPostgreSQLMemorystoreRedisPrivate Services AccessLiteLLM dataplaneGKEInternal ALBsLLM / mgmtLB proxiesCloud SQLPostgreSQLMemorystoreRedisPrivate Services AccessControl planeGKE · replicasInternal ALBHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)

GCP VPC networks are global and subnets are regional. VPC Network Peering connects the separate networks. Configure global access for regional internal load balancers for cross-region management traffic.

Hybrid cloud​

Manage an AWS data plane and an on-premises data plane through one control plane in AWS. Applications use the data plane in their own region or data center.

Hybrid cloud: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
Hybrid cloud: Global Control PlaneCorporate administrators reach one control plane through private ingress in us-east-1. The control plane sends management requests over VPC peering and Site-to-Site VPN to independent LiteLLM dataplanes in us-east-2 and on-premises data center. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and AWS dataplane share one AWS account. The on-premises dataplane runs Kubernetes in the corporate data center. AWS Site-to-Site VPN carries private management HTTPS over an encrypted IPsec tunnel.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · VPN / Direct ConnectAdmins / automationApplications: region AApplications: on-premisesAWS accountCorporate data centerus-east-1Management VPCPrivate subnetsControl-plane data subnetsOutbound HTTPSus-east-2Dataplane A VPCPrivate EKS subnetPrivate ingressPrivate data subnetsProduction networkDataplane BKubernetes subnetPrivate ingressPrivate data subnetsVPC peering · HTTPS 443AWS Site-to-Site VPN · IPsecManagement HTTPS 443PostgreSQLRuntime configRedisConfig streamLiteLLM dataplaneEKSInternal ALBsLLM / mgmtAurora PostgreSQLElastiCacheRedisLiteLLM dataplaneKubernetesPrivate ingressesLLM / mgmtPostgreSQLRedisVPN routerControl planeEKS · replicasInternal ALBHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)
Hybrid cloud: Global Control Plane
ManagementInferencePrivate dataOutbound HTTPS
Hybrid cloud: Global Control PlaneCorporate administrators reach one control plane through private ingress in us-east-1. The control plane sends management requests over VPC peering and Site-to-Site VPN to independent LiteLLM dataplanes in us-east-2 and on-premises data center. Metadata and usage responses return through the same path. Each dataplane has separate private frontends for inference and management. Applications call the inference frontend. Only the control plane can reach the management frontend. The paired ingress icons represent these two frontends. The control plane uses dedicated PostgreSQL for runtime configuration and Redis for its configuration stream. These stores connect privately and are separate from each dataplane’s PostgreSQL and Redis.The control plane and AWS dataplane share one AWS account. The on-premises dataplane runs Kubernetes in the corporate data center. AWS Site-to-Site VPN carries private management HTTPS over an encrypted IPsec tunnel.The control plane uses outbound HTTPS for audit export and optional OIDC discovery and token exchange. When a dataplane uses OIDC token exchange authentication, it fetches signing keys from the identity provider over HTTPS. Dataplanes initiate the JWKS requests. Control-plane OIDC login can also use service tokens to authenticate to dataplanes, without this JWKS path.Corporate network · VPN / Direct ConnectAdmins / automationApplications: region AApplications: on-premisesAWS accountCorporate data centerus-east-1Management VPCPrivate subnetsControl-plane data subnetsOutbound HTTPSus-east-2Dataplane A VPCPrivate EKS subnetPrivate ingressPrivate data subnetsProduction networkDataplane BKubernetes subnetPrivate ingressPrivate data subnetsVPC peering · HTTPS 443AWS Site-to-Site VPN · IPsecManagement HTTPS 443PostgreSQLRuntime configRedisConfig streamLiteLLM dataplaneEKSInternal ALBsLLM / mgmtAurora PostgreSQLElastiCacheRedisLiteLLM dataplaneKubernetesPrivate ingressesLLM / mgmtPostgreSQLRedisVPN routerControl planeEKS · replicasInternal ALBHTTPS 443JWKS · OIDC token exchangeAudit sinkIdP (optional)

The management VPC's VPN cannot provide corporate access through VPC peering to the AWS data plane. See peering limitations. You can use Direct Connect with a private virtual interface instead of VPN.

LiteLLM Enterprise
SSO/SAML, audit logs, spend tracking, multi-team management, and guardrails, built for production.
Learn more →