Qué hace Weblate
Weblate es una plataforma de traducción continua: en lugar de exportar archivos a mano, le da la dirección del repositorio Git de su aplicación. Lee los archivos de idioma — gettext PO, JSON (i18next, vue-i18n), XLIFF, YAML, Android, iOS, ARB, propiedades Java — y presenta cada cadena a los traductores en un editor web. Las traducciones aprobadas vuelven al repositorio como commits, o como pull requests si prefiere revisar.
El proyecto se publica bajo licencia GPL-3.0. La imagen Docker oficial se apoya en PostgreSQL y en Valkey (o Redis) para la caché y la cola de tareas. En un VPS, cuente con unos 1,7 GB de memoria en reposo con dos procesos de trabajo.
Lo que le ofrece Weblate
- Una sola fuente de verdad: Git — los desarrolladores añaden las cadenas en el código y las traducciones vuelven al mismo repositorio.
- Controles de calidad — variables que faltan, etiquetas rotas, espacios y puntuación, plurales incompletos.
- Árabe sin apaños — edición de derecha a izquierda y seis formas de plural.
- Revisión explícita — cada cadena puede marcarse como pendiente de edición, traducida o aprobada.
- Memoria de traducción y glosario — los términos de su producto, siempre traducidos igual.
- Sugerencias automáticas — desde su propio LibreTranslate u otro servicio de traducción.
Plataforma alojada o Weblate en su VPS
Desplace la tabla
| Plataforma alojada (Crowdin, Lokalise…) | Weblate en su VPS | |
|---|---|---|
| Dónde viven las cadenas | Servidores del proveedor | Su VPS |
| Vínculo con el código | Integración con Git | Integración con Git |
| Cuentas de traductores | Según el plan | Tantas como quiera |
| Textos no publicados | En un tercero | En su servidor |
| Licencia del servidor | Servicio propietario | GPL-3.0 |
Requisitos
Un VPS Ubuntu 24.04 con 4 GB de RAM y 2 vCPU. Necesita Docker con el plugin Compose, nginx y certbot en el host, y un nombre (weblate.example.com en esta guía) que apunte a la IP del VPS. Prevea también una cuenta SMTP que escuche en el puerto 587 con TLS: Weblate envía por correo las invitaciones y los restablecimientos de contraseña.
Instalar Weblate con Docker Compose
Preparar la carpeta y el archivo .env
El mismo archivo sirve a Docker Compose y al contenedor de Weblate.
WEBLATE_REGISTRATION_OPEN=0cierra el registro yWEBLATE_REQUIRE_LOGIN=1exige iniciar sesión para leer cualquier cosa. Sustituya las tres líneas SMTP por las de su proveedor.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 .envEscribir el archivo docker-compose.yml
Tres servicios: PostgreSQL, Valkey protegido con contraseña y Weblate. El puerto solo se publica en la interfaz local: solo nginx quedará expuesto a 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: {}Arrancar y comprobar
El primer arranque crea la base de datos y la cuenta
admin, lo que tarda de uno a dos minutos. El punto de salud debe responder200, y el último comando muestra la contraseña de administrador: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
No publique una instancia abierta
Con WEBLATE_REGISTRATION_OPEN=1, cualquiera puede crear una cuenta en su instancia, y sin WEBLATE_REQUIRE_LOGIN=1 los proyectos públicos se leen sin cuenta — incluidas las cadenas de una función aún no anunciada. Mantenga los dos ajustes de esta guía y deje el puerto en 127.0.0.1.
Publicar Weblate en HTTPS con nginx
Cree /etc/nginx/sites-available/weblate con este bloque de servidor y actívelo con un enlace simbólico en sites-enabled. La cabecera X-Forwarded-Proto es imprescindible: es la que indica a Weblate que la petición llegó por 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;
}
}Compruebe la configuración, recargue nginx y solicite el certificado; certbot añade por sí mismo el bloque HTTPS y la redirección desde HTTP.
sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d weblate.example.comDespués abra https://weblate.example.com/accounts/login/ e inicie sesión con el usuario admin.
Traducir su primer repositorio Git
Cree un proyecto y después un componente. Indique la URL del repositorio, la rama y la máscara de archivos de idioma — por ejemplo locales/*.json para vue-i18n o locale/*/LC_MESSAGES/django.po para Django. Weblate clona el repositorio, detecta los idiomas presentes y le propone añadir otros.
Para que devuelva las traducciones, abra Gestión › Claves SSH, genere la clave de la instancia y añádala como clave de despliegue con permiso de escritura en el repositorio; luego indique la URL de push del componente por SSH. Weblate agrupa los cambios y los envía como commits. Para que se actualice en cuanto un desarrollador envíe código, declare un webhook hacia https://weblate.example.com/hooks/github/ (también existen /hooks/gitlab/ y /hooks/gitea/).
Todo se controla también por la API REST, con el token que aparece en su perfil:
curl -s https://weblate.example.com/api/projects/ \
-H "Authorization: Token <API_TOKEN>"Conectar LibreTranslate para las sugerencias
Weblate ofrece sugerencias automáticas bajo cada cadena. Si tiene su propia instancia de LibreTranslate, abra Gestión › Servicios de traducción y añada el servicio LibreTranslate con la URL de su instancia y su clave de API. Los traductores ven entonces una propuesta en árabe, francés, inglés o español, que corrigen antes de aprobar: el texto no sale de sus servidores. El mismo ajuste existe a nivel de proyecto si quiere reservarlo a algunos.
Copias de seguridad y actualización
Hay dos cosas que respaldar: la base PostgreSQL y el volumen weblate-data, que contiene la clave secreta de la instancia, las claves SSH y los clones de los repositorios.
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 .Para actualizar, lea primero las notas de versión en GitHub, haga una copia y cambie la etiqueta de la imagen; Weblate aplica sus migraciones al arrancar:
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 -dWeblate en un clic en ServOrbit
En un VPS de ServOrbit, Weblate se instala desde el Marketplace. El script despliega la imagen oficial con PostgreSQL y Valkey, genera la contraseña de administrador y las de los servicios, cierra el registro, exige iniciar sesión y configura el proxy inverso nginx en HTTPS — en un subdominio de uno de sus dominios o en el subdominio gratuito del VPS. Inicia sesión con el usuario admin y la contraseña de su área de cliente, y conecta su primer repositorio como arriba. Solo queda configurar el SMTP para invitar a sus traductores.
servorbit.com/ma-es/blog/autoalojar-weblate-vps-plataforma-traduccion