For AI agents: the complete documentation index is at llms.txt. Markdown versions are available by appending .md or sending Accept: text/markdown.
Reflex Logo
Docs Logo
Hosting

/

Config File

Cloud Config File

Create cloud.yml

Run:

The command creates cloud.yml, which defines how Reflex Cloud should deploy the app.

File structure

Every field is optional:

Options reference

Option

Type

Default

Description

name

string

folder name

Deployment identifier in dashboard

description

string

empty

Description of deployment

regions

object

sjc: 1

Region deployment mapping

vmtype

string

c1m1

Virtual machine specifications

hostname

string

null

Custom subdomain

envfile

string

.env

Environment variables file path

project

uuid

null

Project uuid

projectname

string

null

Project name

packages

array

empty

Additional system packages

include_db

boolean

false

Include local sqlite

strategy

string

auto

Deployment strategy

Configuration details

Projects

Organize deployments using projects:

You can also specify a project uuid instead of name:

Copy the project ID from the project's settings in Reflex Build.

Apt Packages

Install additional system packages your application requires. Package names are based on the apt package manager:

Include SQLite

Include local sqlite database:

This database is not persistent and is lost when the app restarts. Use a database service for production data.

Strategy

Deployment strategy: Available strategies:

  • immediate: [Default] Deploy immediately
  • rolling: Deploy in a rolling manner
  • bluegreen: Deploy in a blue-green manner
  • canary: Deploy in a canary manner, boot as single machine verify its health and then restart the rest.

Multi-Environment Setup

Development (cloud-dev.yml):

Staging (cloud-staging.yml):

Production (cloud-prod.yml):

Deploy with specific configuration files:

Built with Reflex