Fabro runs as a server. The CLI authenticates and communicates with that server, whether the server is running on your laptop or on a remote host. Choose where the server runs based on how you use Fabro.Documentation Index
Fetch the complete documentation index at: https://docs.fabro.sh/llms.txt
Use this file to discover all available pages before exploring further.
Two deployment modes
| Local | Self-hosted | |
|---|---|---|
| Where the server runs | Your laptop | A host you operate (Docker container) |
| How to start it | fabro server start | docker compose up -d |
| Best for | Solo use, getting started, learning | Teams, production, 24/7 workflows |
| Trade-off | Workflows pause when your laptop sleeps or shuts off | You operate the host |
Local
Runfabro server start on your machine. State persists under ~/.fabro/. The CLI talks to it over a Unix socket by default. This is the right mode for solo use and getting started — no deployment required.
When your laptop sleeps or shuts off, in-flight workflows pause until the laptop wakes again. For workflows that need to run 24/7 or for teams sharing a single instance, self-host.
See Server Operations for starting the server, the install wizard, authentication, and pointing the CLI at it.
Self-hosted
For team use, production workflows, or running 24/7, self-host the server as a Docker container. The recommended approach isdocker compose for a single host, or any cloud container service (ECS, Cloud Run, Kubernetes) using the same image with the same requirements.
Self-host with Docker
Compose-first walkthrough. Same image works on ECS, Cloud Run, and Kubernetes.
Deploy to Railway
One-click managed shortcut for the same Docker image.