Skip to main content
Manage deployable services in config and inspect service records on a floo app. Apps can have multiple services and managed infrastructure.

list

List all services for an app.
floo services list --app my-app

Flags

FlagDescriptionDefault
--app APPApp name or UUIDinferred from config
--env ENVEnvironment to query: dev or proddev

JSON output

{
  "success": true,
  "data": {
    "services": [
      {
        "name": "web",
        "service_type": "web",
        "port": 3000,
        "status": "live",
        "ingress": "public"
      },
      {
        "name": "worker",
        "service_type": "worker",
        "port": null,
        "status": "live",
        "ingress": "internal"
      }
    ]
  }
}

info

Show details for a service (type, status, ingress, URL, port). Also works for provisioned managed services.
floo services info web --app my-app

Flags

FlagDescription
--app APPApp name or UUID

JSON output

{
  "success": true,
  "data": {
    "name": "web",
    "service_type": "web",
    "port": 3000,
    "status": "live",
    "ingress": "public",
    "url": "https://my-app.on.getfloo.com"
  }
}

Adding and removing services

All services are declared in config files. Edit floo.app.toml directly to add or remove services — there is no CLI command for this. Changes take effect on the next deploy (push to GitHub or floo redeploy). See the configuration guide for the full config format.

Errors

CodeMeaning
NOT_AUTHENTICATEDRun floo auth login first
SERVICE_NOT_FOUNDNo service with that name exists