Skip to main content
git push is the primary deploy flow. Use floo redeploy only when you need to trigger a build without a code change — for example, after updating env vars or changing access mode.
Force a redeploy from the current GitHub HEAD. 
floo redeploy [PATH]

​
Arguments

ArgumentDescriptionDefault
PATHProject directory. (current directory)

​
Flags

FlagDescription
--app APPExisting app name or UUID to deploy to
--services NAMEDeploy only specific services (repeatable)
--rebuildForce a full rebuild from the latest commit (re-downloads source and runs Cloud Build)
--sync-envRe-sync env vars from configured env_file before deploying

​
Examples

# Redeploy current directory
floo redeploy

# Redeploy a specific app
floo redeploy --app my-app

# Force a full rebuild from latest commit
floo redeploy --rebuild --app my-app

# Re-sync env vars from env_file before redeploying
floo redeploy --sync-env --app my-app

# Redeploy only specific services
floo redeploy --services api --services web

# Agent workflow: redeploy and extract URL
floo redeploy --json 2>/dev/null | jq -r '.data.deploy.url'

​
What happens

  1. Preflight — validates config, checks ports, service names, env files, and Dockerfiles
  2. API — sends deploy request to the floo API
  3. Managed Services — provisions any missing Postgres, Redis, or Storage resources
  4. Build — API pulls source from connected GitHub repo and builds from your Dockerfile
  5. Deploy — image is pushed to Artifact Registry and deployed to Cloud Run
  6. URL — live URL is returned
Source is always pulled from GitHub. Code is never uploaded from your machine.

​
JSON output

{
  "success": true,
  "data": {
    "app": {
      "id": "a1b2c3d4-...",
      "name": "my-app",
      "status": "live",
      "url": "https://my-app.on.getfloo.com"
    },
    "deploy": {
      "id": "e5f6g7h8-...",
      "status": "live",
      "url": "https://my-app.on.getfloo.com",
      "build_logs": "..."
    },
    "detection": {
      "runtime": "nodejs",
      "framework": "Next.js",
      "version": "^14.0.0",
      "confidence": "high"
    },
    "services": ["web"]
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
INVALID_PATHPath is not a valid directory
NO_CONFIG_FOUNDNo floo.app.toml found. Run floo init first
CONFIG_INVALIDPreflight validation failed
APP_NOT_FOUNDThe --app value doesn’t match any existing app
DEPLOY_FAILEDBuild or deploy failed. Check build logs
DEPLOY_TIMEOUTDeploy timed out after 10 minutes