docs/hosting/bring-your-own-cloud.md
Bring Your Own Cloud (BYOC) lets you deploy Reflex apps to your own AWS, GCP, or Azure account with the same reflex cloud deploy command you already use. Everything runs inside your account: the build runs on your cloud's builders, the image is pushed to your internal registry, and the app runs on your cloud's managed runtime. Reflex never holds standing credentials into your account, and nothing about the app or its data leaves your perimeter.
# Enterprise tier only.
BYOC is part of the **Enterprise tier** of Reflex Cloud. Contact [[email protected]](mailto:[email protected]) to upgrade.
Reflex Cloud takes you from a Python file to a live app in one command, but that app runs on Reflex's infrastructure — a non-starter for teams whose cloud is fixed by security review, procurement, or data-residency policy. If the deployment target isn't approved, the app doesn't ship.
The alternative is to build the deploy yourself on Cloud Run, ECS, or Container Apps: a Dockerfile, a build pipeline, a registry, runtime config, infrastructure-as-code, and ongoing maintenance. That's its own engineering project, and most of it has nothing to do with your app.
BYOC keeps the Reflex Cloud workflow your team already uses — app lifecycle, autoscaling, environment variables, and the deploy CLI all behave the way they always have. The only thing that changes is where the container ends up running.
The same reflex cloud deploy command works against each cloud with a single flag:
reflex cloud deploy --aws
reflex cloud deploy --gcp
reflex cloud deploy --azure
| Cloud | Flag | Managed runtime |
|---|---|---|
| AWS | --aws | ECS |
| GCP | --gcp | Cloud Run |
| Azure | --azure | Container Apps |
Running reflex cloud deploy --<cloud> kicks off a short interactive flow:
aws, gcloud, or az) is installed and that you're logged in, and walks you through aws configure, gcloud auth login, or az login if you're not. From there everything runs under your credentials.The final output is the URL of the live app, running in your own account. The whole flow takes about three minutes the first time, and under a minute on subsequent deploys.
BYOC is generally available on AWS, GCP, and Azure for Reflex Enterprise customers. It supports:
reflex cloud deploy --<cloud>.