Ce que fait LibreTranslate
LibreTranslate expose une API HTTP qui reçoit un texte, sa langue source et une langue cible, et renvoie la traduction. Les modèles sont ceux d'Argos Translate, un moteur de traduction neuronale qui fonctionne sans connexion : une fois téléchargés, ils tournent sur le processeur du VPS, sans carte graphique et sans appel à un service extérieur.
Le projet est publié sous licence AGPL-3.0. Il fournit aussi une interface web pour traduire à la main un texte ou un fichier, une détection de langue, et une gestion de clés d'API avec une limite de requêtes par clé. Sur un VPS, c'est la brique qui permet à un site, à un SaaS ou à un outil interne de parler plusieurs langues sans dépendre d'un fournisseur.
Ce que LibreTranslate apporte
- Une API simple —
/translate,/detectet/languages, en JSON, appelables depuis n'importe quel langage. - L'arabe et le français — avec l'anglais et l'espagnol, quatre langues chargées d'emblée, dans toutes les combinaisons.
- La détection de langue — une source
autopour les messages dont vous ignorez la langue. - La traduction de fichiers — txt, docx, odt, pptx, epub, html, srt et pdf.
- Des clés d'API — une par application, chacune avec sa limite de requêtes par minute.
- La confidentialité — les textes restent sur votre serveur, et rien n'est facturé au caractère.
LibreTranslate face aux API en ligne
Faites défiler le tableau
| LibreTranslate | Google Cloud Translation | DeepL API | |
|---|---|---|---|
| Hébergement | Votre VPS | Cloud Google | Cloud DeepL |
| Où vont les textes | Restent sur le serveur | Envoyés au fournisseur | Envoyés au fournisseur |
| Facturation | Le VPS seul | Au caractère | Au caractère |
| Qualité | Correcte, relecture conseillée | Très bonne | Très bonne |
| Code source | Ouvert (AGPL-3.0) | Fermé | Fermé |
Prérequis
Un VPS Ubuntu 24.04 avec 2 Go de RAM et 2 vCPU suffit pour quatre langues et un trafic modeste ; prévoyez 4 Go si plusieurs applications traduisent en même temps. Comptez environ 750 Mo de disque pour les modèles des quatre langues, puis une centaine de mégaoctets par paire ajoutée.
Il vous faut Docker avec le plugin Compose, nginx et certbot sur l'hôte, et un nom (traduction.example.com dans ce guide) qui pointe vers l'IP du VPS.
Installer LibreTranslate avec Docker Compose
Écrire le fichier docker-compose.yml
Dans un dossier dédié (
/opt/libretranslate), créez ce fichier. Le port est publié sur la seule boucle locale.LT_API_KEYSactive la base de clés,LT_UNDER_ATTACKrefuse toute requête sans clé valide, interface web comprise, etLT_LOAD_ONLYlimite le téléchargement aux quatre langues utiles.services: libretranslate: image: libretranslate/libretranslate:v1.9.6 restart: unless-stopped ports: - "127.0.0.1:5000:5000" environment: LT_API_KEYS: "true" LT_UNDER_ATTACK: "true" LT_LOAD_ONLY: "en,fr,ar,es" LT_THREADS: "2" volumes: - lt-db:/app/db - lt-models:/home/libretranslate/.local volumes: lt-db: lt-models:Démarrer et attendre les modèles
Au premier démarrage, LibreTranslate télécharge les modèles avant d'ouvrir le port : suivez les journaux jusqu'à la ligne
Listening at.docker compose up -d docker compose logs -f libretranslateCréer votre première clé
La base de clés est créée au démarrage. Ajoutez une clé limitée à 120 requêtes par minute ; la commande l'affiche une seule fois.
docker compose exec libretranslate ./venv/bin/ltmanage keys add 120Vérifier que la clé est exigée
La première requête, sans clé, doit être refusée ; la seconde renvoie
translatedText.curl -s http://127.0.0.1:5000/translate -H "Content-Type: application/json" \ -d '{"q":"Bonjour","source":"fr","target":"en"}' curl -s http://127.0.0.1:5000/translate -H "Content-Type: application/json" \ -d '{"q":"Bonjour","source":"fr","target":"en","api_key":"VOTRE_CLE"}'
Ne publiez jamais une instance sans clé
Sans LT_API_KEYS ni LT_UNDER_ATTACK, LibreTranslate traduit pour quiconque connaît l'adresse. Une instance ouverte est vite trouvée et utilisée par des robots : c'est votre processeur qui travaille pour eux. Gardez le port sur 127.0.0.1 et laissez nginx seul face à Internet.
Placer LibreTranslate derrière nginx en HTTPS
Créez un server block dans /etc/nginx/sites-available/ et activez-le. client_max_body_size fixe la taille maximale d'un fichier envoyé à traduire : sans cette ligne, nginx refuse tout envoi de plus de 1 Mo.
server {
server_name traduction.example.com;
client_max_body_size 20m;
location / {
proxy_pass http://127.0.0.1:5000;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_read_timeout 300s;
}
}Puis vérifiez la configuration et demandez le certificat :
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d traduction.example.comAppeler l'API depuis une application
Toute requête est un POST JSON avec le texte (q), la langue source (source, ou auto), la langue cible (target) et la clé (api_key).
curl -s https://traduction.example.com/translate -H "Content-Type: application/json" \
-d '{"q":"Votre commande est expédiée.","source":"fr","target":"ar","api_key":"VOTRE_CLE"}'En Python, la même requête tient en quelques lignes :
import requests
r = requests.post(
"https://traduction.example.com/translate",
json={"q": "Your invoice is ready.", "source": "auto", "target": "es", "api_key": "VOTRE_CLE"},
timeout=30,
)
print(r.json()["translatedText"])/languages liste les paires disponibles, /detect renvoie la langue d'un texte avec un indice de confiance, et /translate_file traduit un fichier envoyé en multipart.
Gérer les clés d'API et les limites
Créez une clé par application ou par client : vous pourrez en révoquer une sans toucher aux autres, et chaque clé porte sa propre limite de requêtes par minute. Depuis le dossier de l'application :
docker compose exec libretranslate ./venv/bin/ltmanage keys
docker compose exec libretranslate ./venv/bin/ltmanage keys add 60
docker compose exec libretranslate ./venv/bin/ltmanage keys remove <cle>Une clé inconnue reçoit Invalid API key, une requête sans clé Please contact the server operator to get an API key. Dans l'interface web, l'icône en forme de clé (« Set API Key ») en haut de la page enregistre la clé dans le navigateur.
Régler LibreTranslate pour un petit VPS
Quatre variables d'environnement suffisent à adapter l'instance à la taille du serveur. LT_THREADS fixe le nombre de processus de traduction : chacun charge les modèles en mémoire, d'où la valeur de 2 sur un VPS de 2 Go ; montez-la si vous avez de la RAM et plusieurs applications qui traduisent en parallèle. LT_CHAR_LIMIT plafonne la longueur d'un texte par requête, ce qui évite qu'un seul appel occupe un processus pendant des minutes. LT_DISABLE_FILES_TRANSLATION coupe la traduction de fichiers si vous ne l'utilisez pas, et LT_DISABLE_WEB_UI retire l'interface web pour ne garder que l'API.
Après chaque changement dans docker-compose.yml, relancez avec docker compose up -d : le conteneur est recréé, les volumes et donc les clés et les modèles sont conservés. Surveillez la mémoire avec docker stats pendant une journée d'usage réel avant de fixer ces valeurs pour de bon.
Ce qu'il faut savoir sur la qualité
Les modèles d'Argos Translate sont bien plus petits que ceux des services commerciaux. La traduction reste fiable pour comprendre un message, trier des tickets, produire un premier jet ou traduire du contenu courant ; elle est moins sûre sur les tournures idiomatiques, le vocabulaire très spécialisé et les textes longs et littéraires.
Une règle simple : traduisez automatiquement ce qui sert à comprendre, et faites relire par une personne ce qui sera publié sous votre nom — pages de vente, conditions générales, courriels marketing. Testez aussi vos propres phrases dans les deux sens avant de brancher une application : la qualité varie d'une paire de langues à l'autre, et l'anglais sert souvent de pivot entre deux langues qui ne sont pas l'anglais.
Ajouter des langues, sauvegarder et mettre à jour
Pour ajouter une langue, complétez LT_LOAD_ONLY avec son code (de, it, pt, tr…) et relancez avec docker compose up -d : les modèles manquants se téléchargent au démarrage.
À sauvegarder : le seul volume lt-db, qui contient la base des clés. Les modèles de lt-models se retéléchargent d'eux-mêmes, et LibreTranslate ne conserve pas les textes traduits. Pour mettre à jour, changez le tag de l'image dans docker-compose.yml après avoir lu les notes de version, puis :
docker compose pull
docker compose up -dInstallation en un clic sur ServOrbit
Sur un VPS ServOrbit, LibreTranslate s'installe depuis le Marketplace : le script déploie l'image officielle avec l'arabe, le français, l'anglais et l'espagnol, génère votre clé d'API, ferme l'instance à toute requête sans clé et configure nginx en HTTPS. L'adresse est un sous-domaine de l'un de vos domaines ou le sous-domaine gratuit du VPS, certificat compris, et la clé s'affiche dans votre espace client.
servorbit.com/ma-fr/blog/self-host-libretranslate-vps