Skip to main content
floo deploys is for viewing and managing deploy history. To trigger a deploy, push to GitHub or use floo redeploy. To validate your config before pushing, use floo preflight.

​
How deploys are triggered

Deploys are config-as-code and git-driven — there is no floo deploy step in the everyday flow.
TriggerResult
git push to your default branchBuilds and deploys to the dev environment automatically.
Cut a GitHub release on your repoPromotes that build to production.
floo redeploy --app <name>Re-runs the same image (e.g. after an env-var change), no rebuild.
floo redeploy --rebuild --app <name>Forces a new build from the latest commit.
After floo apps github connect <owner/repo>, you almost never need to run a deploy command directly — push, and the build starts. Watch progress with floo deploys watch --app <name> or in the dashboard.

​
Subcommands

​
floo deploys list

List deploy history for an app, newest first. 
floo deploys list --app my-app
FlagDescription
--app APPApp name or UUID

​
floo deploys logs [DEPLOY_ID]

Show build logs for a deploy. If DEPLOY_ID is omitted, shows logs for the latest deploy. 
floo deploys logs abc123 --app my-app
floo deploys logs abc123 --app my-app --follow
FlagDescription
--app APPApp name or UUID
--followStream logs in real-time for active deploys

​
floo deploys watch

Stream deploy progress in real-time. Waits for the deploy to finish and shows build logs as they arrive. 
floo deploys watch --app my-app
floo deploys watch --app my-app --commit abc1234
FlagDescription
--app APPApp name or UUID
--commit SHAMatch a deploy by commit SHA prefix (waits up to 120s)

​
floo deploys status

Print a compact, agent-safe deploy status summary. Emits the latest deploy’s id, commit, derived phase booleans (image_built / service_ready / host_bound), the gateway URL, and a recommended next command — without dumping build logs, Cloud Run audit payloads, or env-var values. Built for agents and scripts that need to know “what state is the deploy in?” without risking secret exfiltration through verbose output. 
floo deploys status --app my-app
floo deploys status --app my-app --id e5f6g7h8 --json
FlagDescription
--app APPApp name or UUID
--id IDDeploy ID. Defaults to the latest deploy for the app
--jsonMachine-readable output for agents

​
floo deploys rollback APP DEPLOY_ID

Rollback to a previous deploy. 
floo deploys rollback my-app abc123
floo deploys rollback my-app abc123 --force --json
FlagDescription
--forceSkip confirmation prompt

​
JSON output

{
  "success": true,
  "data": {
    "deploys": [
      {
        "id": "e5f6g7h8-...",
        "status": "live",
        "url": "https://my-app.on.getfloo.com",
        "created_at": "2026-04-06T12:00:00Z"
      }
    ]
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
APP_NOT_FOUNDThe --app value doesn’t match any existing app
DEPLOY_NOT_FOUNDThe deploy ID doesn’t match any deploy for this app