Skip to main content

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.

The server interface is in private early access. Contact bryan@qlty.sh if you’re interested in trying it.
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.

Two deployment modes

LocalSelf-hosted
Where the server runsYour laptopA host you operate (Docker container)
How to start itfabro server startdocker compose up -d
Best forSolo use, getting started, learningTeams, production, 24/7 workflows
Trade-offWorkflows pause when your laptop sleeps or shuts offYou operate the host
Both modes use the same image, the same workflow engine, and the same CLI. The only difference is where the server process lives.

Local

Run fabro 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 is docker 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.