Votre serveur, votre coordinateur.

Le coordinateur open-core tourne sur du matériel qui vous appartient. La seule exigence, c’est Docker — aucune base, aucun cache, aucune file à exploiter, et aucune restriction de fonctionnalité dans ce qui est livré.

install ▸ trois commandes

Mettez-le debout.

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

Puis ouvrez http://localhost:8000 et créez votre compte. Le premier build est lent parce que le runtime d’extraction documentaire et d’OCR est intégré : l’extraction fonctionne hors ligne ensuite.

Connecter le premier agent

Dans l’app : Fleet → Connect a new agent, qui fabrique un code d’appairage. Puis, sur la machine qui fera le travail :

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

domaine ▸ une commande

Domaine public et HTTPS.

Une commande fait passer une installation de localhost à un vrai nom d’hôte avec un vrai certificat :

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

1. Vérifie Docker, les ports, et que votre domaine pointe déjà sur ce serveur.
2. Écrit tous les réglages dérivés du domaine dans le fichier d’environnement, de façon cohérente.
3. Lève le reverse proxy fourni avec des certificats Let’s Encrypt automatiques.
4. Attend le certificat et vérifie l’URL HTTPS en direct.

Au quotidien

Du Docker Compose ordinaire, parce que ce n’est rien d’autre. Ajoutez --profile tls à ces commandes si vous avez déployé avec le reverse proxy :

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

secrets ▸ huit obligatoires

Les secrets sans lesquels la stack ne démarre pas.

./scripts/gen-env.sh les génère tous les huit pour vous. En production, la stack refuse de démarrer si l’un d’eux est absent, vide, ou plus court que 32 caractères :

Réglages de production

Quatre réglages pèsent vraiment une fois passé localhost :

exécution ▸ deux conteneurs

Ce qui tourne réellement.

Deux conteneurs, plus un reverse proxy optionnel. Aucune base, aucun cache, aucune file externe à exploiter, sauvegarder ou mettre à jour.

compte ▸ propriétaire unique

Le premier compte.

Renseignez l’e-mail, le mot de passe et le nom de l’administrateur dans le fichier d’environnement avant le premier démarrage — ou laissez le mot de passe vide et terminez l’installation dans le navigateur, avec l’e-mail pré-rempli sur la page de configuration.

mcp ▸ writ-selfhost

Pointer un assistant vers votre coordinateur.

Votre coordinateur s’enregistre comme writ-selfhost, volontairement — pour cohabiter avec l’app Writ Desktop, qui s’enregistre comme writ, et avec Writ Cloud, qui s’enregistre comme 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>" }
    }
  }
}

périmètre ▸ dedans et dehors

Ce qui est dans la boîte, et ce qui n’y est pas.

Inclus, sans restriction de fonctionnalité

Tout ceci est livré dans le build auto-hébergé et n’est bridé par aucun plan :

• Enregistrement et édition des étapes
• L’assistant IA dans l’enregistreur, avec votre propre clé de fournisseur
• Personas avec TOTP et OTP, et sessions chaudes
• Exécution et planification
• Moniteurs — disponibilité, certificats et historique des changements
• Automatisations
• Crawl distribué sur votre propre flotte
• Extraction documentaire et OCR
• Publication d’endpoints REST
• Outils MCP
• Une surface de chat compatible OpenAI
• Datasets, avec export

Absent du build auto-hébergé

Ce sont des surfaces que Writ exploite plutôt qu’il ne livre. Elles sont absentes, pas dégradées :

• La marketplace
• La facturation et l’application des plans
• Les organisations multi-tenants
• L’IA gérée — l’auto-hébergement fonctionne uniquement avec vos propres clés
• La sortie résidentielle gérée
• Les agents cloud provisionnés et l’autoscaling
• SSO et SCIM
• Scribe

mise à jour ▸ licence

Mises à jour et licence.

Pour mettre à jour, tirez le dépôt et reconstruisez — les trois mêmes commandes qu’au départ, sans le clone.

référence ▸ suite

Continuer

faq

Questions d’auto-hébergement, répondues.

fin ▸ déployer

Clonez-le et levez-le.

Trois commandes pour un coordinateur qui fonctionne, une de plus pour le mettre sur votre domaine.