Skip to main content

Hybrid Deployment Guide

Hybrid mode lets you run application workloads in your own cloud while Relay manages data services like Postgres, Redis, and authentication.

Typical Use Cases​

  • Keep core APIs in your VPC while delegating databases and cache to Relay.
  • Customise routing, observability, or security controls beyond the managed defaults.
  • Transition gradually from fully managed to self-hosted infrastructure.

Architecture Snapshot​

Customer Cloud (API, workers, frontend)
        ↕    secure connectivity (VPN / Private Link / TLS allowlists)
Relay Managed Control Plane (Postgres, Redis, Auth)

Onboarding Flow​

  1. Activate Hybrid Plan – The portal provisions managed Postgres/Redis endpoints and issues a hybrid bundle (.env.hybrid).
  2. Connect Networking – Establish secure connectivity from your cloud to the managed endpoints.
  3. Deploy Application Layer – Use the Docker image or Helm chart from this repository, set DEPLOYMENT_MODE=hybrid, and apply the environment bundle.
  4. Register Services – Run smoke tests and benchmarks to confirm connectivity before promoting traffic.

Operations​

  • Managed components update through the SaaS control plane.
  • Your application layer stays under your change-management process; integrate the smoke/benchmark scripts into CI.
  • Forward metrics either to Relay dashboards or your own observability stack.

For guidance on moving between deployment modes, contact the Relay team via the customer portal.