flowmetrics

Run the dashboard locally

Diátaxis: How-to. Foreground flow serve — tied to your terminal, dies when the shell does. For a service that survives logout, see Run as a persistent web server.

flow serve \
    --workflows-dir CONTRACTS_DIR \
    --data-dir       DATA_DIR
# → http://127.0.0.1:8000

• Reads only from the local Parquet warehouse. Never hits GitHub / Jira during a request.
• --port N picks an alternate port.
• --host 0.0.0.0 binds publicly and requires --password <…> (or $FLOW_PASSWORD). HTTP Basic auth is then enforced.

Stopping

Ctrl-C in the terminal. There is no daemon to manage in this mode.

Next

• Run as a persistent web server — for a dashboard that survives logout, reboots, and crashes.
• Troubleshooting § port already in use