Tu servidor, tu coordinador.

El coordinador open-core corre en hardware tuyo. El único requisito es Docker — ninguna base de datos, caché ni cola externa que operar, y ninguna función capada en lo que se entrega.

install ▸ tres comandos

Levántalo.

git clone https://github.com/usewrit/writ.git && cd writ
./scripts/gen-env.sh
docker compose up -d --build

Luego abre http://localhost:8000 y crea tu cuenta. El primer build es lento porque el runtime de extracción documental y OCR va integrado: a partir de ahí la extracción funciona sin conexión.

Conecta el primer agente

En la app: Fleet → Connect a new agent, que acuña un código de emparejamiento. Después, en la máquina que hará el trabajo:

curl -fsSL http://localhost:8000/agent.sh | sh -s -- WRIT-4K2P-9XQ

dominio ▸ un comando

Dominio público y HTTPS.

Un comando lleva una instalación de localhost a un hostname real con un certificado real:

./scripts/deploy.sh writ.example.com [email protected]

1. Comprueba Docker, los puertos y que tu dominio ya apunta a este servidor.
2. Escribe todos los ajustes derivados del dominio en el archivo de entorno, de forma coherente.
3. Levanta el proxy inverso incluido con certificados Let’s Encrypt automáticos.
4. Espera al certificado y verifica la URL HTTPS en vivo.

El día a día

Docker Compose corriente, porque no es otra cosa. Añade --profile tls a cualquiera de estos si desplegaste con el proxy inverso:

docker compose logs -f
docker compose restart
docker compose down

# Removes the data volumes too — this deletes your data.
docker compose down -v

# Add --profile tls to any of these if you deployed with the reverse proxy.
docker compose --profile tls logs -f

secretos ▸ ocho obligatorios

Secretos sin los que la pila no arranca.

./scripts/gen-env.sh genera los ocho por ti. En producción la pila se niega a arrancar si alguno está ausente, vacío o mide menos de 32 caracteres:

Ajustes de producción

Cuatro ajustes pesan de verdad en cuanto sales de localhost:

ejecución ▸ dos contenedores

Qué corre de verdad.

Dos contenedores, más un proxy inverso opcional. No hay base de datos, caché ni cola externa que operar, respaldar o actualizar.

cuenta ▸ dueño único

La primera cuenta.

Pon el email, la contraseña y el nombre del administrador en el archivo de entorno antes del primer arranque — o deja la contraseña en blanco y termina la configuración en el navegador, con el email ya rellenado en la página de setup.

mcp ▸ writ-selfhost

Apunta un asistente a tu propio coordinador.

Tu coordinador se registra como writ-selfhost, a propósito — para convivir con la app Writ Desktop, que se registra como writ, y con Writ Cloud, que se registra como writ-cloud.

claude mcp add writ-selfhost -e WRIT_API_KEY=<YOUR_API_KEY> \
  -- npx -y writ-mcp --url http://localhost:8000

{
  "mcpServers": {
    "writ-selfhost": {
      "type": "http",
      "url": "http://localhost:8000/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

alcance ▸ dentro y fuera

Qué viene en la caja y qué no.

Incluido, sin funciones capadas

Todo esto viene en el build autoalojado y no lo restringe ningún plan:

• Grabación y edición de pasos
• El asistente de IA en el grabador, con tu propia clave de proveedor
• Personas con TOTP y OTP, y sesiones calientes
• Ejecución y programación
• Monitors — disponibilidad, certificados e historial de cambios
• Automatizaciones
• Crawl distribuido sobre tu propia flota
• Extracción documental y OCR
• Publicación de endpoints REST
• Herramientas MCP
• Una superficie de chat compatible con OpenAI
• Datasets, con exportación

No está en el build autoalojado

Son superficies que Writ opera en lugar de entregar. Están ausentes, no degradadas:

• El marketplace
• Facturación y aplicación de planes
• Organizaciones multiinquilino
• IA gestionada — el autoalojamiento funciona solo con tus propias claves
• Salida residencial gestionada
• Agentes cloud aprovisionados y autoescalado
• SSO y SCIM
• Scribe

actualizar ▸ licencia

Actualizaciones y licencia.

Para actualizar, haz pull del repositorio y reconstruye — los mismos tres comandos del principio, menos el clone.

referencia ▸ siguiente

Sigue

faq

Preguntas de autoalojamiento, respondidas.

fin ▸ desplegar

Clónalo y levántalo.

Tres comandos para un coordinador funcionando, y uno más para ponerlo en tu propio dominio.