Skip to main content
Declare managed services in floo.app.toml. They are auto-provisioned on your first deploy.

Add to your config

[app]
name = "my-app"

[postgres]
tier = "basic"

[redis]

[storage]

[cron.daily-report]
schedule = "0 9 * * *"
command = "python scripts/report.py"
service = "web"

[services.web]
type = "web"
path = "."
port = 3000
ingress = "public"
The only field for infrastructure services is tier with values basic, standard, and performance. Omitting tier defaults to basic. Cron jobs have their own fields — see below.

What gets provisioned

ServiceSectionEnv vars
Postgres[postgres]DATABASE_URL
Redis[redis]REDIS_URL
Storage[storage]STORAGE_BUCKET, STORAGE_URL
Cron[cron.<name>]n/a (runs commands in a service’s container)

Env var scoping

Managed service env vars (DATABASE_URL, REDIS_URL, STORAGE_BUCKET) are provisioned at app scope and available to all services by default. In multi-service apps with a frontend, this means DATABASE_URL is visible to your web container. If that’s a concern, set secrets on specific services instead:
floo env set DATABASE_URL=postgres://... --app my-app --services api
See the environment variables guide for full scoping rules and security best practices.

Deploy and verify

floo preflight --json
floo apps github connect owner/repo --app my-app
floo deploys watch --app my-app
After deploy:
floo env list --app my-app
floo env get DATABASE_URL --app my-app

Tiers

Postgres

Basic (default)StandardPerformance
Max connections51550
Statement timeout30s60s120s
Idle-in-transaction timeout60s120s300s
work_mem64 MB128 MB256 MB
Start with basic. Move to standard if you have multiple services sharing one database or need longer queries.

Redis

Redis is provisioned via Upstash (serverless). All tiers use the same infrastructure. Omit tier.

Storage

Storage is provisioned as a GCS bucket. All tiers use the same infrastructure. Omit tier.

Usage metering

ResourceMetered by
Compute (Cloud Run)per vCPU-second + per GiB-second
Postgresshared instance, metered by compute
Redisserverless (Upstash), metered by commands
Storageper GB stored + per operation
Bandwidthper GB egress
Your plan includes a monthly compute credit (5free/hobby,5 free/hobby, 20 pro, $200 team). Usage beyond the credit is billed as overage up to your spend cap.

Databases

Code examples and debugging for Postgres and Redis.

Cloud Storage

Upload, download, and signed URL patterns.

Cron Jobs

Schedule recurring tasks inside your app’s containers.