CLI commands

--app is optional inside a directory with floo.app.toml; pass it when running commands from elsewhere. Agents can drive the same operations through the HTTP API instead of the CLI.

Ship changes

Commit and push to GitHub. The deploy triggers automatically.

git add . && git commit -m "feat: my change"
git push origin main
floo deploys watch --app my-app

Find the command

Before you connect: a human installs the floo GitHub App on the account that owns the repo, then links it to your floo org with floo apps github setup. An organization installation does not cover personal-account repos, or the reverse. See Granting the floo GitHub App access.

I want to…	Run this
Create an account or log in	`floo auth login`
Deploy for the first time	`floo apps github connect owner/repo`
Ship a code change	`git push origin main`
Validate my config before pushing	`floo preflight` (local only, no auth needed)
Apply env var changes by redeploying the current image, no rebuild	`floo redeploy --app my-app`
Rebuild the GitHub default branch’s current HEAD without a code change	`floo redeploy --rebuild --app my-app`
Watch a deploy in progress	`floo deploys watch --app my-app`
See deploy history	`floo deploys list --app my-app`
Roll back to a previous version	`floo deploys rollback my-app <id>`
Set a public env var	`floo env set PUBLIC_API_ORIGIN=https://api.example.com --config --app my-app`
Read custom-domain DNS records	`floo domains show app.example.com --app my-app`
View logs	`floo logs query --app my-app`
Run locally with dev managed-service credentials	`floo dev --app my-app` (requires `dev_command` in config)

Task recipes

Add env vars and redeploy

floo env set API_KEY --stdin --secret --app my-app
floo redeploy --app my-app

Add a database

Declare the database in floo.app.toml:

[managed.default]
type = "postgres"

Preflight, commit, and push the declaration:

floo preflight
git add floo.app.toml && git commit -m "feat: add postgres"
git push origin main

The next deploy provisions it and injects DATABASE_URL plus standard PG* variables. Postgres is fully isolated between dev and prod. Declare Redis with type = "redis" and Storage with type = "storage"; see Managed Services: Dev and prod isolation for the full model.

Add a custom domain

Declare the domain in floo.app.toml, naming your target service:

[domains."app.example.com"]
service = "web"

Commit and push the config, then wait for that commit’s dev deploy to go live. Publish a release to prod and read the DNS records:

gh release create v1 --repo <owner/repo>
floo domains show app.example.com --app my-app

Publish the traffic and certificate CNAME records printed by show at your DNS provider, then watch activation:

floo domains watch app.example.com --app my-app

See Custom domains for DNS setup and troubleshooting.

Roll back a bad deploy

floo deploys list --app my-app
floo deploys rollback my-app <deploy-id>

Debug a failing deploy

floo deploys logs <deploy-id> --app my-app
floo logs query --app my-app --since 1h --error

How floo works

The mental model. Config in the repo, GitHub-backed deploys, CLI or API.

Configuration

Understand floo.app.toml and how services are declared.

CLI

Config and runtime

Errors

API

CLI commands

Ship changes

Find the command

Task recipes

Add env vars and redeploy

Add a database

Add a custom domain

Roll back a bad deploy

Debug a failing deploy

How floo works

Configuration

​Ship changes

​Find the command

​Task recipes

​Add env vars and redeploy

​Add a database

​Add a custom domain

​Roll back a bad deploy

​Debug a failing deploy

How floo works

Configuration

Ship changes

Find the command

Task recipes

Add env vars and redeploy

Add a database

Add a custom domain

Roll back a bad deploy

Debug a failing deploy