Installez Escriba chez vous

Escriba est livré sous la forme d’une seule image Docker préconstruite qui inclut déjà tout ce dont elle a besoin — ffmpeg, Tesseract OCR, Whisper et un Redis embarqué. Il n’y a aucun service supplémentaire à câbler. Récupérez-la, définissez un mot de passe, et vous disposez d’un moteur privé de conversion document-vers-Markdown qui tourne sur votre propre infrastructure.

Pourquoi auto-héberger ?

Vos documents sont convertis sur votre machine puis supprimés juste après. Rien n’est conservé, rien n’est envoyé vers un cloud tiers. Le contrôle reste sur la couche humaine — c’est vous qui décidez de ce qui parvient un jour à un LLM.

Démarrage rapide

Récupérez l’image et lancez-la avec une seule commande :

Lancer Escriba

docker run -d --name escriba --restart unless-stopped -p 8000:8000 \
-e SECRET_KEY="$(openssl rand -hex 32)" \
-e GOD_PASSWORD="change-me" \
ghcr.io/diegoparras/escriba:latest

Ouvrez ensuite http://localhost:8000 et connectez-vous avec le GOD_PASSWORD que vous avez défini.

Note

L’image inclut ffmpeg, Tesseract OCR, Whisper et un Redis embarqué. Aucun service supplémentaire n’est requis. Générez des clés avec openssl rand -hex 32.

Déployer sur votre plateforme

Tout fonctionne à partir de l’unique image ci-dessus. Choisissez la plateforme que vous utilisez.

EasyPanel

1. Project → + Service → App, puis réglez Source → Docker Image sur ghcr.io/diegoparras/escriba:latest.
2. Ajoutez vos variables d’environnement (voir Configuration).
3. Sous Domains, définissez le Container Port 8000, ajoutez votre domaine et activez le HTTPS.
4. Deploy.

Docker Compose

git clone https://github.com/diegoparras/escriba.git
cd escriba
cp .env.example .env          # set your secrets
docker compose up -d --build

Portainer

Stacks → Add stack → Repository en utilisant https://github.com/diegoparras/escriba et le chemin compose docker-compose.yml (ou collez le fichier compose dans l’éditeur web). Définissez les variables d’environnement et déployez ; l’application écoute sur le port 8000.

Dokploy

Create Application → GitHub (dépôt diegoparras/escriba) avec Build Type : Dockerfile, ajoutez vos variables d’environnement, réglez le domaine sur le Container Port 8000 avec HTTPS, puis déployez.

Docker simple

docker build -t escriba .
docker run -d --name escriba --restart unless-stopped -p 8000:8000 \
-e SECRET_KEY="$(openssl rand -hex 32)" -e GOD_PASSWORD="change-me" escriba

Pour le TLS, placez un reverse proxy devant. Avec Caddy, un Caddyfile de deux lignes vous offre un HTTPS automatique :

Caddyfile

example.com {
    reverse_proxy localhost:8000
}

Configuration minimale

Tous les paramètres sont des variables d’environnement. Le minimum recommandé :

.env

SECRET_KEY=<openssl rand -hex 32>   # required in production
GOD_PASSWORD=<a strong password>
ANGEL_PASSWORD=<optional>
HUMAN_PASSWORD=<optional>

Si aucun mot de passe n’est défini, un GOD_PASSWORD aléatoire est généré et affiché dans les logs du conteneur au démarrage. Consultez la liste complète dans Configuration.

Prérequis

L’application de base est légère : un VPS 1 cœur / 2 Go avec ~5 Go de disque suffit réellement pour démarrer, et Escriba adapte le nombre de workers à votre CPU. Le module optionnel d’anonymisation des PII de niveau entreprise (Anonimal) est plus lourd — ne le montez que lorsque vous en avez besoin.

Soyez sûr avant de déployer

Nous indiquons des specs minimales et recommandées honnêtes pour chaque configuration — application de base, anonymisation de niveau entreprise et transcription lourde — pour qu’il ne semble jamais que « ça ne marche pas » à cause de votre machine. Voir tous les prérequis système →

Guide de déploiement complet Toutes les options de configuration