Skip to main content
Manage environment variables for your apps. Values are encrypted at rest.

​
set

Set an environment variable. Keys are auto-uppercased. 
floo env set KEY=value --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--services SVCTarget specific services (repeatable)
--restartRestart the app after setting (redeploy with fresh env vars)

​
Examples

floo env set DATABASE_URL=postgres://user:pass@host:5432/db --app my-app
floo env set STRIPE_SECRET_KEY=sk_live_... --app my-app
floo env set NODE_ENV=production --app my-app --restart
floo env set API_KEY=secret --app my-app --services api --services worker

​
JSON output

{
  "success": true,
  "data": {
    "key": "DATABASE_URL",
    "masked_value": "postgres://us...***"
  }
}

​
get

Get the plaintext value of an environment variable. 
floo env get DATABASE_URL --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--service SVCTarget a specific service

​
JSON output

{
  "success": true,
  "data": {
    "key": "DATABASE_URL",
    "value": "postgres://user:pass@host:5432/db"
  }
}

​
list

List all environment variables for an app. Values are masked. 
floo env list --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--services SVCTarget specific services (repeatable)

​
JSON output

{
  "success": true,
  "data": {
    "env_vars": [
      { "key": "DATABASE_URL", "masked_value": "postgres://us...***" },
      { "key": "STRIPE_SECRET_KEY", "masked_value": "sk_live_...***" }
    ]
  }
}

​
remove

Remove an environment variable. Keys are auto-uppercased. 
floo env remove DATABASE_URL --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--services SVCTarget specific services (repeatable)

​
JSON output

{
  "success": true,
  "data": {
    "key": "DATABASE_URL"
  }
}

​
import

Import environment variables from a .env file. 
floo env import .env --app my-app

​
Flags

FlagDescription
--app APPApp name or UUID (reads from config if omitted)
--services SVCTarget specific services (repeatable). Cannot combine with --all.
--allImport env vars for all services using their configured env_file paths. Cannot combine with FILE or --services.

​
Examples

# Import from a specific .env file
floo env import .env --app my-app

# Import for specific services
floo env import .env --app my-app --services api --services worker

# Import for all services using their configured env_file paths
floo env import --all --app my-app

# Agent workflow: import and verify
floo env import .env --app my-app --json 2>/dev/null | jq '.data'

​
JSON output

{
  "success": true,
  "data": {
    "imported": 5,
    "keys": ["DATABASE_URL", "REDIS_URL", "SECRET_KEY", "API_KEY", "NODE_ENV"]
  }
}

​
Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
APP_NOT_FOUNDNo app with that name or ID
INVALID_FORMATMissing = in KEY=VALUE argument