Guide de déploiement

Weblate sur VPS : traduisez vos applications depuis Git

Déployer sur un VPS Cloud →

Tutoriel

Self-hosting

Weblate sur VPS : traduisez vos applications depuis Git

Traduire une application en arabe, en français et en anglais finit souvent en fichiers JSON échangés par e-mail, en variables cassées et en traductions qui arrivent après la version. Weblate règle le problème à la source : il se branche sur votre dépôt Git, montre chaque chaîne aux traducteurs dans le navigateur et renvoie les traductions validées en commits. Ce guide l'installe sur un VPS avec Docker Compose, le ferme aux inconnus, le publie en HTTPS derrière nginx et y branche un premier dépôt.

6 min de lecture3 étapes
Sommaire· Ce que fait Weblate1/11
  1. 01Ce que fait Weblate
  2. 02Ce que Weblate vous donne
  3. 03Plateforme hébergée ou Weblate sur votre VPS
  4. 04Prérequis
  5. 05Installer Weblate avec Docker Compose
  6. 06Ne publiez pas une instance ouverte
  7. 07Publier Weblate en HTTPS avec nginx
  8. 08Traduire votre premier dépôt Git
  9. 09Brancher LibreTranslate pour les suggestions
  10. 10Sauvegarder et mettre à jour
  11. 11Installer Weblate en un clic sur ServOrbit

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înesServeurs de l'éditeurVotre VPS
Lien avec le codeIntégration GitIntégration Git
Comptes des traducteursSelon l'offre souscriteAutant que vous voulez
Textes non publiésChez un tiersChez vous
Licence du serveurService propriétaireGPL-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

  1. Préparer le dossier et le fichier .env

    Le même fichier sert à Docker Compose et au conteneur Weblate. WEBLATE_REGISTRATION_OPEN=0 ferme les inscriptions et WEBLATE_REQUIRE_LOGIN=1 exige 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
  2. É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: {}
  3. 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épondre 200, 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.com

Ouvrez 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 -d

Installer 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.

Partager cet articleservorbit.com/ma-fr/blog/self-host-weblate-vps