Deploy an app from Codex

Codex runs the floo CLI to write the config, push it, and deploy. Any language works when the repository has a Dockerfile that serves on 0.0.0.0:$PORT; floo init offers to write one for a detected runtime.

Set up your agent

Install the CLI and sign in from your own terminal, before starting Codex:

curl -fsSL https://getfloo.com/install.sh | bash
floo auth login

From the project root, install the floo skill where Codex reads skills, and point AGENTS.md at the agent guide:

floo skills install --path .agents/skills/floo
echo 'For floo work, read https://getfloo.com/docs/guides/agent-setup.' >> AGENTS.md

Every floo command calls https://api.getfloo.com. When Codex runs in its workspace-write sandbox, allow network access in ~/.codex/config.toml:

~/.codex/config.toml

[sandbox_workspace_write]
network_access = true

Agent prompt

Paste into Codex. Replace my-app with your app name.

Deploy this app to floo. App name: my-app.
Confirm the floo org with `floo orgs list`. If the org has no plan, have me run `floo billing upgrade`.
Run `floo init my-app`. Set the port in floo.app.toml to the port the app listens on, and declare any Postgres, Redis, or Storage the app needs under [managed.<name>].
Run `floo preflight --json` and fix every error.
Commit and push to the default branch.
Have me open https://github.com/apps/getfloo/installations/new, choose the repository's owner, and select this repository. Wait for me to confirm.
Run `floo apps github setup --no-browser` and give me the printed link. Wait for me to confirm GitHub access.
Run `floo apps github connect <owner>/<repo> --no-browser`.
Run `floo deploys status --app my-app --json` until the deploy is live, then report the URL.

floo.app.toml

The smallest config floo init writes for one web service:

floo.app.toml

[app]
name = "my-app"

[services.web]
type = "web"
path = "."
port = 3000
ingress = "public"

Add [managed.default] with type = "postgres" for a database, access_mode = "accounts" under [app] for App sign-in, and [cron.<name>] for scheduled jobs. Patterns: Configuring an app.

CLI commands

The same deploy by hand. Replace owner/my-app with your repository.

floo init my-app
floo preflight
git add . && git commit -m "chore: deploy to floo"
git push origin main
floo apps github setup
floo apps github connect owner/my-app
floo deploys watch --app my-app

floo apps github setup needs the floo GitHub App installed on the repository’s owner first. See Quickstart steps 2 and 3.

Verify

floo deploys status --app my-app --json
floo logs query --app my-app --error

deploys status reports the live URL once the deploy is live. Load the URL, then read logs query --error for anything the app raised while serving it. Every push to main deploys to dev. To publish to prod, run gh release create v1 --repo <owner>/<repo>. See Environments.

Start without GitHub

floo can host the repository. floo projects create makes a Next.js app with App sign-in and managed Postgres, deploys it, and returns its URL, with no GitHub steps:

floo projects create my-app
floo projects clone my-app

Start Codex in the cloned folder. Every push deploys to dev; floo releases promote --app my-app publishes to prod. See projects.

Next steps

Build with your stack

End-to-end guides for Next.js, Rails, FastAPI, Django, and Express.

Agent setup

JSON output, verification, and credential rules for agents.

Logs and debugging

Runtime logs, build logs, and a debug loop for a failed deploy.

Agent webhooks

Send failed deploys and repeated errors to your agent.

Get started

Build with your stack

Deploy from your agent

Configure your app

Ship and release

Data

Domains and networking

App users and access

Operate

Team and billing

For agents

Deploy an app from Codex

Set up your agent

Agent prompt

floo.app.toml

CLI commands

Verify

Start without GitHub

Next steps

Build with your stack

Agent setup

Logs and debugging

Agent webhooks

​Set up your agent

​Agent prompt

​floo.app.toml

​CLI commands

​Verify

​Start without GitHub

​Next steps

Build with your stack

Agent setup

Logs and debugging

Agent webhooks

Set up your agent

Agent prompt

floo.app.toml

CLI commands

Verify

Start without GitHub

Next steps