Skip to content

Cloud providers

Cloud providers map devflow workspaces onto managed database branching — no local containers at all. They implement the same provider interface, so switch, connection, hooks, and cleanup behave identically.

Workspace = Neon branch. Instant CoW branching on Neon’s storage.

services:
- name: cloud-db
type: neon
service_type: postgres
auto_workspace: true
neon:
api_key: ${NEON_API_KEY} # ${ENV_VAR} interpolation supported
project_id: ${NEON_PROJECT_ID}
base_url: https://console.neon.tech/api/v2 # default

Workspace = DBLab clone — thin clones of a full-size PostgreSQL instance, great for production-sized data.

services:
- name: staging-db
type: dblab
service_type: postgres
auto_workspace: true
dblab:
api_url: https://dblab.example.com
auth_token: ${DBLAB_TOKEN}

Workspace = Xata branch (PostgreSQL-compatible platform).

services:
- name: xata-db
type: xata
service_type: postgres
auto_workspace: true
xata:
api_key: ${XATA_API_KEY}
organization_id: my-org
project_id: my-project
base_url: https://api.xata.tech # default
  • Secrets stay out of the committed file via ${ENV_VAR} interpolation; put real values in your environment or .devflow.local.yml.
  • Cloud services are skipped by devflow service up / the daemon (nothing local to keep alive).
  • Mixing is fine: a Neon database alongside local Redis and RustFS in one project.