> ## Documentation Index
> Fetch the complete documentation index at: https://getfloo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Host apps built with AI

> Deploy an app built with your agent, with Postgres, sign-in, and scheduled jobs.

Your agent can deploy your app with `floo deploy`. Declare services, managed Postgres, sign-in, and scheduled jobs in `floo.app.toml`. When a deploy fails or a runtime error repeats, floo can send the context to your agent.

## What an app built with AI needs

| Need | On floo | Guide |
| - | - | - |
| A URL from one command | `floo deploy` builds the `Dockerfile` and serves it at `https://<app>.getfloo.app` | [Quickstart](https://getfloo.com/docs/introduction.md) |
| A database | `[managed.default] type = "postgres"`; the app reads `DATABASE_URL` | [Postgres](https://getfloo.com/docs/guides/postgres.md) |
| Sign-in for your team | `access_mode = "accounts"`; floo's gateway signs people in and sends your code `X-Floo-User-Email` | [App sign-in](https://getfloo.com/docs/guides/app-auth.md) |
| Sign-up for your customers | Customer sign-up and log-in | [User accounts](https://getfloo.com/docs/guides/user-accounts.md) |
| Scheduled jobs | `[cron.<name>]` runs a command on a UTC schedule | [Cron jobs](https://getfloo.com/docs/guides/cron-jobs.md) |
| Secrets | `floo env set KEY --stdin` stores a write-only value outside git | [Environment variables](https://getfloo.com/docs/guides/environment-variables.md) |
| Safe changes | Every push deploys to dev; prod runs only what you release; previews per pull request | [Production environments](https://getfloo.com/docs/guides/environments.md) |
| Knowing when it breaks | `floo logs`, `floo events list`, and webhooks to your agent | [Agent webhooks](https://getfloo.com/docs/guides/agent-webhooks.md) |

The agent drives all of it through the floo CLI, where every command takes `--json`, or the HTTP API at `https://api.getfloo.com/v1`. When `floo deploy --json` stops, `error.next` lists the fix, so the agent knows what to run next.

## Deploy one

The app needs a `Dockerfile` that serves on `0.0.0.0:$PORT`. [Dockerfiles](https://getfloo.com/docs/guides/dockerfiles.md) has one to copy for each common stack.

```bash theme={null}
curl -fsSL https://getfloo.com/install.sh | bash
floo auth login
floo init my-app
floo deploy --preflight
git add . && git commit -m "chore: configure floo"
floo deploy
```

`floo deploy` deploys from the GitHub repository the folder pushes to. A folder with no remote takes `floo deploy --github` (a new private repository in your account) or `floo deploy --hosted` (floo hosts the code). A new org needs a plan first: `floo billing upgrade`.

A typical app with a database, team sign-in, and a nightly job:

```toml floo.app.toml theme={null}
[app]
name = "my-app"
access_mode = "accounts"

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

[managed.default]
type = "postgres"

[cron.nightly]
schedule = "0 2 * * *"
command = "python -m jobs.nightly"
service = "web"
```

For an app open to the public, set `access_mode = "public"`. Every key is in the [config reference](https://getfloo.com/docs/reference/config-spec.md).

## One config instead of several accounts

Review changes to app configuration in git. Dev and prod use separate managed databases, and previews get their own database branches. See [Preview environments](https://getfloo.com/docs/guides/preview-environments.md) for data options.

## Start from your agent

> [card] [Claude Code](https://getfloo.com/docs/deploy/fastapi-postgres-claude-code.md)
>
> A FastAPI app with Postgres and migrations from one prompt.

> [card] [Cursor](https://getfloo.com/docs/deploy/nextjs-sign-in-cursor.md)
>
> A Next.js app behind invite-only sign-in.

> [card] [Codex](https://getfloo.com/docs/deploy/codex.md)
>
> Any app with a Dockerfile, from a GitHub repository or one floo hosts.

> [card] [Internal tool or admin dashboard](https://getfloo.com/docs/deploy/internal-tool.md)
>
> Team sign-in, app roles, Postgres, and a daily scheduled job.

> [card] [App for your customers](https://getfloo.com/docs/deploy/customer-app.md)
>
> A public prod URL, your own domain, and invite-only dev.

> [card] [Without GitHub](https://getfloo.com/docs/deploy/without-github.md)
>
> A local git repository to a live URL with one command.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.