Home

Writ self-host

Record a web task once. Replay it forever — free every run, on hardware you own.

This wiki is the operator's manual for the self-hosted coordinator (usewrit/writ). It assumes nothing beyond Docker and a terminal.

Start here

Quickstart	Three commands to a running install.
Connecting agents	Nothing executes until one agent is connected. Read this second.
Configuration	Every environment variable, what it does, and which are required.

Using it

Workflows	Record a browser task, edit it as steps, replay it.
Monitors	Watch a page or selector; uptime, SSL expiry, change history.
Crawling	Point a distributed crawl at a whole site.
Documents and OCR	PDFs, office files and scanned pages, read offline.
Personas and secrets	Logins, 2FA and credentials, encrypted at rest.
Automations	Chain events to actions — run, webhook, notify.
Datasets	Everything a run collected, searchable and exportable.

Connecting other software

REST API	Publish a workflow as an HTTP endpoint. API keys and scopes.
MCP	Give an AI assistant your workflows as tools.
OpenAI-compatible API	Serve a workflow at /v1/chat/completions.

Running it properly

Production deployment	TLS, reverse proxy, host allowlist, hardening.
Backup and restore	What to back up, and the one file that is not in the volume.
Upgrading	Pull, rebuild, migrate.
Security model	Trust boundaries, what is encrypted, how to report a vulnerability.
Troubleshooting	Symptoms, causes and fixes for the things that actually go wrong.

Understanding it

Architecture	Which process does what, and why the split exists.
Development	Run from source, the test suite, the CI gates.
FAQ	Short answers.

---

Licensed AGPL-3.0-only. If you modify the coordinator and let others use it over a network, you owe them your source — see Security model.