---
title: "Flow Server"
space: "Framework"
url: "https://docs.frappe.io/framework/flow/flow-server"
updated: "2026-11-18"
---

The Flow server is a background process that runs the chats, and one server handles every site on a bench. You only need this page if you run your own bench.

Creating a site starts the server, but nothing brings it back after a crash or a reboot. In production, run it under Supervisor.

## Commands

| Command                     | What it does                                                   |
| --------------------------- | -------------------------------------------------------------- |
| `bench flow-server status`  | Shows whether the server is running and which sites it serves. |
| `bench flow-server start`   | Starts the server.                                             |
| `bench flow-server stop`    | Stops the server.                                              |
| `bench flow-server restart` | Restarts the server. Run it after you update Frappe.           |


The log is at `logs/flow-server.log` in the bench folder.

## Run under Supervisor

You only need this on a self-hosted bench. On Frappe Cloud, the Flow server is managed for you.

1. Add `"flow_server_manager": "supervisor"` to `common_site_config.json`.
2. Add a Supervisor program that runs `bench flow-server serve` with `autorestart=true`, then reload Supervisor.

From then on, Supervisor starts and stops the server.