Ce que fait Weblate
Weblate est une plateforme de traduction continue : au lieu d'exporter des fichiers à la main, vous lui donnez l'adresse du dépôt Git de votre application. Il lit les fichiers de langue — gettext PO, JSON (i18next, vue-i18n), XLIFF, YAML, Android, iOS, ARB, propriétés Java — et présente chaque chaîne aux traducteurs dans un éditeur web. Les traductions validées repartent dans le dépôt sous forme de commits, ou de pull requests si vous préférez relire.
Le projet est publié sous licence GPL-3.0. L'image Docker officielle s'appuie sur PostgreSQL et sur Valkey (ou Redis) pour le cache et la file des tâches. Sur un VPS, comptez environ 1,7 Go de mémoire au repos avec deux processus de travail.
Ce que Weblate vous donne
- Une source de vérité unique : Git — les développeurs ajoutent les chaînes dans le code, les traductions reviennent dans le même dépôt.
- Des contrôles qualité — variables manquantes, balises cassées, espaces et ponctuation, pluriels incomplets.
- L'arabe sans bricolage — édition de droite à gauche et six formes de pluriel.
- Une relecture explicite — chaque chaîne peut être marquée à revoir, traduite ou approuvée.
- Mémoire de traduction et glossaire — vos termes produits traduits toujours de la même façon.
- Des suggestions automatiques — depuis votre propre LibreTranslate ou un autre service de traduction.
Plateforme hébergée ou Weblate sur votre VPS
Faites défiler le tableau
| Plateforme hébergée (Crowdin, Lokalise…) | Weblate sur votre VPS | |
|---|---|---|
| Où vivent les chaînes | Serveurs de l'éditeur | Votre VPS |
| Lien avec le code | Intégration Git | Intégration Git |
| Comptes des traducteurs | Selon l'offre souscrite | Autant que vous voulez |
| Textes non publiés | Chez un tiers | Chez vous |
| Licence du serveur | Service propriétaire | GPL-3.0 |
Prérequis
Un VPS Ubuntu 24.04 avec 4 Go de RAM et 2 vCPU. Il vous faut Docker avec le plugin Compose, nginx et certbot sur l'hôte, et un nom (weblate.example.com dans ce guide) qui pointe vers l'IP du VPS. Prévoyez aussi un compte SMTP qui écoute sur le port 587 avec TLS : Weblate envoie par e-mail les invitations et les réinitialisations de mot de passe.
Installer Weblate avec Docker Compose
Préparer le dossier et le fichier .env
Le même fichier sert à Docker Compose et au conteneur Weblate.
WEBLATE_REGISTRATION_OPEN=0ferme les inscriptions etWEBLATE_REQUIRE_LOGIN=1exige une connexion pour lire quoi que ce soit. Remplacez les trois lignes SMTP par celles de votre fournisseur.mkdir -p /opt/weblate && cd /opt/weblate cat > .env <<EOF WEBLATE_SITE_DOMAIN=weblate.example.com WEBLATE_ENABLE_HTTPS=1 WEBLATE_SECURE_PROXY_SSL_HEADER=HTTP_X_FORWARDED_PROTO,https WEBLATE_IP_PROXY_HEADER=HTTP_X_FORWARDED_FOR [email protected] WEBLATE_ADMIN_PASSWORD=$(openssl rand -hex 16) WEBLATE_REGISTRATION_OPEN=0 WEBLATE_REQUIRE_LOGIN=1 [email protected] [email protected] WEBLATE_EMAIL_HOST=smtp.example.com [email protected] WEBLATE_EMAIL_HOST_PASSWORD=<SMTP_PASSWORD> POSTGRES_HOST=database POSTGRES_DB=weblate POSTGRES_USER=weblate POSTGRES_PASSWORD=$(openssl rand -hex 16) REDIS_HOST=cache REDIS_PASSWORD=$(openssl rand -hex 16) EOF chmod 600 .envÉcrire le fichier docker-compose.yml
Trois services : PostgreSQL, Valkey protégé par mot de passe, et Weblate. Le port n'est publié que sur la boucle locale : seul nginx sera exposé à Internet.
services: database: image: postgres:18.7-alpine restart: unless-stopped environment: POSTGRES_DB: weblate POSTGRES_USER: weblate POSTGRES_PASSWORD: "${POSTGRES_PASSWORD}" volumes: - weblate-db:/var/lib/postgresql cache: image: valkey/valkey:9.1.3 restart: unless-stopped command: ["valkey-server", "--save", "60", "1", "--requirepass", "${REDIS_PASSWORD}"] volumes: - weblate-redis:/data weblate: image: weblate/weblate:2026.11.2.0 restart: unless-stopped depends_on: [database, cache] env_file: .env ports: - "127.0.0.1:8080:8080" volumes: - weblate-data:/app/data - weblate-cache:/app/cache tmpfs: [/run, /tmp] volumes: weblate-db: {} weblate-redis: {} weblate-data: {} weblate-cache: {}Démarrer et vérifier
Le premier démarrage crée la base et le compte
admin, ce qui prend une à deux minutes. Le point de santé doit répondre200, et la dernière commande affiche le mot de passe administrateur :docker compose up -d docker compose ps curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/healthz/ grep WEBLATE_ADMIN_PASSWORD .env
Ne publiez pas une instance ouverte
Avec WEBLATE_REGISTRATION_OPEN=1, n'importe qui peut créer un compte sur votre instance, et sans WEBLATE_REQUIRE_LOGIN=1 les projets publics se lisent sans compte — y compris les chaînes d'une fonctionnalité pas encore annoncée. Gardez les deux réglages de ce guide et laissez le port sur 127.0.0.1.
Publier Weblate en HTTPS avec nginx
Créez /etc/nginx/sites-available/weblate avec ce bloc serveur, puis activez-le avec un lien symbolique dans sites-enabled. L'en-tête X-Forwarded-Proto est indispensable : c'est lui qui dit à Weblate que la requête est arrivée en HTTPS.
server {
listen 80;
server_name weblate.example.com;
client_max_body_size 100m;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}Vérifiez la configuration, rechargez nginx et demandez le certificat ; certbot ajoute lui-même le bloc HTTPS et la redirection depuis HTTP.
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d weblate.example.comOuvrez ensuite https://weblate.example.com/accounts/login/ et connectez-vous avec l'utilisateur admin.
Traduire votre premier dépôt Git
Créez un projet, puis un composant. Donnez l'URL du dépôt, la branche et le masque des fichiers de langue — par exemple locales/*.json pour vue-i18n ou locale/*/LC_MESSAGES/django.po pour Django. Weblate clone le dépôt, détecte les langues présentes et vous propose d'en ajouter.
Pour qu'il renvoie les traductions, ouvrez Gestion › Clés SSH, générez la clé de l'instance et ajoutez-la comme clé de déploiement avec droit d'écriture sur le dépôt, puis renseignez l'URL de push du composant en SSH. Weblate regroupe les modifications et les pousse en commits. Pour qu'il se mette à jour dès qu'un développeur pousse du code, déclarez un webhook vers https://weblate.example.com/hooks/github/ (il existe aussi /hooks/gitlab/ et /hooks/gitea/).
Tout se pilote aussi par l'API REST, avec le jeton affiché dans votre profil :
curl -s https://weblate.example.com/api/projects/ \
-H "Authorization: Token <API_TOKEN>"Brancher LibreTranslate pour les suggestions
Weblate propose des suggestions automatiques sous chaque chaîne. Si vous avez votre propre instance LibreTranslate, ouvrez Gestion › Services de traduction, ajoutez le service LibreTranslate avec l'URL de votre instance et sa clé d'API. Les traducteurs voient alors une proposition pour l'arabe, le français, l'anglais ou l'espagnol, qu'ils corrigent avant de valider : le texte ne quitte pas vos serveurs. Le même réglage existe au niveau d'un projet si vous voulez le réserver à certains.
Sauvegarder et mettre à jour
Deux choses à sauvegarder : la base PostgreSQL et le volume weblate-data, qui contient la clé secrète de l'instance, les clés SSH et les clones des dépôts.
cd /opt/weblate
docker compose exec -T database pg_dump -U weblate weblate | gzip > weblate-db-$(date +%F).sql.gz
docker run --rm -v weblate_weblate-data:/data -v "$PWD":/backup alpine:3.22 \
tar czf /backup/weblate-data-$(date +%F).tar.gz -C /data .Pour mettre à jour, lisez d'abord les notes de version sur GitHub, sauvegardez, puis changez le tag de l'image ; Weblate applique ses migrations au démarrage :
cd /opt/weblate
sed -i 's|weblate/weblate:2026.11.2.0|weblate/weblate:<NEW_VERSION>|' docker-compose.yml
docker compose pull && docker compose up -dInstaller Weblate en un clic sur ServOrbit
Sur un VPS ServOrbit, Weblate s'installe depuis le Marketplace. Le script déploie l'image officielle avec PostgreSQL et Valkey, génère le mot de passe administrateur et ceux des services, ferme les inscriptions, exige la connexion et configure le reverse proxy nginx en HTTPS — sur un sous-domaine de l'un de vos domaines ou sur le sous-domaine gratuit du VPS. Vous vous connectez avec l'utilisateur admin et le mot de passe affiché dans votre espace client, puis vous branchez votre premier dépôt comme ci-dessus. Seul le SMTP reste à renseigner pour inviter vos traducteurs.
servorbit.com/ma-fr/blog/self-host-weblate-vps