Instal·lació mitjançant Docker¶
Amb el desplegament de Weblate acoblat, podeu posar en funcionament la vostra instància personal de Weblate en qüestió de segons. Totes les dependències de Weblate ja estan incloses. PostgreSQL es configura com a base de dades predeterminada i Valkey com a backend de memòria cau.
Requisits de maquinari¶
Weblate s’ha d’executar en qualsevol maquinari contemporani sense problemes, la següent és la configuració mínima necessària per executar Weblate en un sol host (Weblate, base de dades i servidor web):
3 GB de RAM
2 nuclis de CPU
1 GB d’espai d’emmagatzematge
Nota
Els requisits reals per a la vostra instal·lació de Weblate varien molt en funció de la mida de les traduccions que hi gestionen.
Memory usage¶
Com més memòria millor: s’utilitza per a la memòria cau a tots els nivells (sistema de fitxers, base de dades i Weblate). Per a centenars de components de traducció, es recomana almenys 4 GB de RAM.
Suggeriment
Per als sistemes amb menys memòria de la recomanada, es recomana Configuració d’api d’un sol procés.
Ús de la CPU¶
Molts usuaris concurrents augmenten la quantitat de nuclis de CPU necessaris.
Weblate 2026.8 introduced NumPy as a required dependency. On x86-64 systems, the optimized NumPy build bundled in the Docker image requires an x86-64-v2 compatible CPU. Without the required CPU features, NumPy fails to load and Weblate cannot start.
Before upgrading, check for the required SSE4.2 CPU feature on the Linux system running Docker:
grep sse4_2 /proc/cpuinfo
Empty output indicates that a required CPU feature is unavailable. This is a preliminary check; finding SSE4.2 does not verify all x86-64-v2 CPU features.
If Docker runs in a virtual machine, run the check inside the guest. Virtual machines can hide CPU features supported by the host. Configure the virtual machine to expose the required host CPU features, then reboot the guest. If the physical CPU lacks the required features, upgrade the hardware.
Storage usage¶
L’ús típic d’emmagatzematge de bases de dades és d’uns 300 MB per cada milió de paraules allotjades.
L’espai d’emmagatzematge necessari per als dipòsits clonats varia, però Weblate intenta mantenir la seva mida mínima fent clons poc profunds.
Storage performance¶
Version control operations perform many filesystem metadata lookups. The
vcs subdirectory in DATA_DIR therefore needs low read
latency; storage with slow metadata access can make operations such as
git status take a long time even when its bulk throughput is good.
Keep CACHE_DIR on low-latency local or temporary storage when
possible.
The deployment checks measure metadata lookup latency for both locations and warn when the median latency exceeds 10 milliseconds. This is an approximate point-in-time measurement affected by filesystem and system load. Rerun weblate check --deploy before changing the storage configuration.
Nodes¶
For small and medium-sized sites (millions of hosted words), all Weblate components (see Architecture overview) can be run on a single node.
Quan arribeu a centenars de milions de paraules allotjades, es recomana tenir un node dedicat per a la base de dades (vegeu Configuració de la base de dades per a Weblate).
Installation¶
Suggeriment
Els exemples següents suposen que teniu un entorn Docker que funciona, amb docker-compose-plugin instal·lat. Consulteu la documentació de Docker per obtenir instruccions.
Això crea un servidor de desplegament de Weblate mitjançant HTTP, de manera que hauríeu de col·locar-lo darrere del servidor intermediari de terminació HTTPS. També podeu implementar amb un servidor intermediari HTTPS, vegeu Certificats SSL automàtics mitjançant Let’s Encrypt. Per a configuracions més grans, consulteu Escala horitzontal.
Clonar el repositori weblate-docker:
git clone https://github.com/WeblateOrg/docker-compose.git weblate-docker cd weblate-docker
Nota
The Docker Compose files are example deployment configurations. Operators typically customize them for their own deployment and maintain those local changes. Weblate application updates are delivered through Docker image tags; there is no release-bound update path for customized Compose files.
Creeu un fitxer
docker-compose.override.ymlamb la vostra configuració. Vegeu Variables d’entorn de Docker per a la llista completa de variables d’entorn.services: weblate: image: weblate/weblate:latest environment: WEBLATE_EMAIL_HOST: smtp.example.com WEBLATE_EMAIL_HOST_USER: user WEBLATE_EMAIL_HOST_PASSWORD: pass WEBLATE_SERVER_EMAIL: weblate@example.com WEBLATE_DEFAULT_FROM_EMAIL: weblate@example.com WEBLATE_SITE_DOMAIN: weblate.example.com WEBLATE_ADMIN_PASSWORD: password for the admin user WEBLATE_ADMIN_EMAIL: weblate.admin@example.com ports: - 80:8080
Nota
Si
WEBLATE_ADMIN_PASSWORDno està definit, l’usuari administrador es crea amb una contrasenya aleatòria que es mostra al primer inici.L’exemple proporcionat fa que Weblate escolti al port 80, editeu l’assignació de ports al fitxer
docker-compose.override.ymlper canviar-lo.Inicieu els contenidors de Weblate:
docker compose up
Gaudeix del teu desplegament Weblate, és accessible al port 80 del contenidor weblate.
Vegeu també
Escollint el registre d’imatges de Docker¶
Els contenidors de Weblate es publiquen als registres següents:
Docker Hub, vegeu https://hub.docker.com/r/weblate/weblate
Registre de paquets de GitHub, vegeu https://github.com/WeblateOrg/docker/pkgs/container/weblate
Nota
Tots els exemples actualment obtenen imatges de Docker Hub, ajusteu la configuració en conseqüència per utilitzar un registre diferent.
Escollint l’etiqueta d’imatge de Docker¶
Trieu una etiqueta que s’adapti al vostre entorn i expectatives:
Tag name |
Descripció |
Cas d’ús |
|---|---|---|
|
Versió estable de Weblate, coincideix amb la darrera versió etiquetada |
Actualitzacions en continu en un entorn de producció |
|
Weblate stable release |
Actualitzacions en continu dins d’un any natural en un entorn de producció |
|
Weblate stable release |
Actualitzacions en continu dins d’un llançament mensual en un entorn de producció |
|
Weblate stable release |
Desplegament ben definit en un entorn de producció |
|
Versió estable de Weblate amb canvis de desenvolupament al contenidor Docker (per exemple, dependències actualitzades) |
Actualitzacions en continu en un entorn de preparació |
|
Versió estable de Weblate amb canvis de desenvolupament al contenidor Docker (per exemple, dependències actualitzades) |
Desplegament ben definit en un entorn de preparació |
|
Versió de desenvolupament Weblate de Git |
Actualitzacions en continu per provar les properes funcions de Weblate |
|
Versió de desenvolupament Weblate de Git |
Desplegament ben definit per provar les properes funcions de Weblate |
Cada imatge és provada pel nostre CI abans de publicar-se, de manera que fins i tot la versió «sagnada» hauria de ser bastant segura d’utilitzar.
La llista completa d’etiquetes publicades es pot trobar a Paquets GitHub
Contenidor Docker amb suport HTTPS¶
Consulteu Installation per obtenir instruccions genèriques de desplegament, aquesta secció només esmenta les diferències en comparació amb ella.
Proxy final SSL¶
SSL es pot cancel·lar fora del contenidor Weblate. Perquè això funcioni bé, cal passar diverses capçaleres al contenidor perquè conegui el seu entorn real. Amb més detall, aquestes capçaleres es descriuen a Corrent darrere del proxy invers.
location / {
proxy_pass http://127.0.0.1:8080;
proxy_read_timeout 3600s;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Host $server_name;
}
WEBLATE_ENABLE_HTTPS=1
WEBLATE_IP_PROXY_HEADER=HTTP_X_FORWARDED_FOR
WEBLATE_TRUSTED_PROXY_ADDRESSES=192.0.2.10
Replace the example trusted proxy address with the address or network of the reverse proxy as seen by the Weblate container. Make sure that untrusted clients cannot reach a published container port by bypassing the reverse proxy.
If the reverse proxy runs on the Docker host, you can give the host gateway a
persistent name in docker-compose.override.yml and trust that name:
services:
weblate:
extra_hosts:
- "host.docker.internal:host-gateway"
environment:
WEBLATE_TRUSTED_PROXY_ADDRESSES: host.docker.internal
Ús de certificats SSL propis¶
En cas que tingueu el propi certificat SSL que voleu utilitzar, simplement col·loqueu els fitxers al volum de dades de Weblate (vegeu Volums de contenidors Docker):
ssl/fullchain.pemque conté el certificat, inclosos els certificats CA necessarisssl/privkey.pemque conté la clau privada
Tots dos fitxers han de ser propietat del mateix usuari que l’usuari que inicia el contenidor docker i tenir la màscara de fitxer configurada a 600 (només llegible i escrivible per l’usuari propietari).
A més, el contenidor Weblate ara acceptarà connexions SSL al port 4443, voldreu incloure el reenviament de ports per a HTTPS a la substitució de la composició de Docker:
version: '3'
services:
weblate:
ports:
- 80:8080
- 443:4443
Si ja allotgeu altres llocs al mateix servidor, és probable que els ports 80 i 443 siguin utilitzats per un servidor intermediari invers, com ara NGINX. Per passar la connexió HTTPS de NGINX al contenidor Docker, podeu utilitzar la configuració següent:
server {
listen 443 ssl;
listen [::]:443 ssl;
server_name <SITE_URL>;
ssl_certificate /etc/letsencrypt/live/<SITE>/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/<SITE>/privkey.pem;
location / {
proxy_set_header HOST $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Host $server_name;
proxy_pass https://127.0.0.1:<EXPOSED_DOCKER_PORT>;
}
}
Substituïu <SITE_URL>, <SITE> i <EXPOSED_DOCKER_PORT> amb valors reals del vostre entorn.
Trusting custom CA certificates¶
Afegit a la versió 2026.11.
When Weblate connects to services secured by certificates issued by a private certificate authority (for example an internal SMTP, LDAP, or Git server), place the CA certificates into the Weblate data volume (see Volums de contenidors Docker):
ssl/ca-certificates/containing one or more.crtfiles in PEM format
On every container start, the certificates are combined with the system CA
bundle and made available to Python (requests), OpenSSL, libcurl, and Git
via REQUESTS_CA_BUNDLE, SSL_CERT_FILE, CURL_CA_BUNDLE, and
GIT_SSL_CAINFO. The system trust store is not modified, and removing a
.crt file from the directory removes it from the bundle on the next
start.
Nota
Only files with the .crt extension are picked up.
Nota
Weblate runs repository operations (clone, fetch, push) with a cleaned-up
environment, but passes the CA certificate variables (SSL_CERT_FILE,
SSL_CERT_DIR, GIT_SSL_CAINFO, GIT_SSL_CAPATH,
REQUESTS_CA_BUNDLE and CURL_CA_BUNDLE) through to Git and other
subprocesses, so HTTPS Git remotes trust the CA as well.
Certificats SSL automàtics mitjançant Let’s Encrypt¶
En cas que vulgueu utilitzar certificats SSL generats automàticament Let’s Encrypt a la instal·lació pública, heu d’afegir un servidor intermediari HTTPS invers i un contenidor Docker addicional, s’utilitzarà https-portal per a això. Això s’utilitza al fitxer docker-compose-https.yml. A continuació, creeu un fitxer docker-compose-https.override.yml amb la vostra configuració:
version: '3'
services:
weblate:
environment:
WEBLATE_EMAIL_HOST: smtp.example.com
WEBLATE_EMAIL_HOST_USER: user
WEBLATE_EMAIL_HOST_PASSWORD: pass
WEBLATE_SITE_DOMAIN: weblate.example.com
WEBLATE_ADMIN_PASSWORD: password for admin user
https-portal:
environment:
DOMAINS: 'weblate.example.com -> http://weblate:8080'
Sempre que invoqueu docker compose, heu de passar-hi els dos fitxers i, a continuació, feu:
docker compose -f docker-compose-https.yml -f docker-compose-https.override.yml build
docker compose -f docker-compose-https.yml -f docker-compose-https.override.yml up
S’està actualitzant el contenidor Docker¶
En general, és una bona idea actualitzar només el contenidor Weblate i mantenir el contenidor PostgreSQL a la versió que teniu, ja que actualitzar PostgreSQL és força dolorós i en la majoria dels casos no aporta molts beneficis.
Podeu fer-ho mantenint-se amb el docker-compose existent i només traieu les últimes imatges i després reinicieu:
# Fetch latest versions of the images
docker compose pull
# Stop and destroy the containers
docker compose down
# Spawn new containers in the background
docker compose up -d
# Follow the logs during upgrade
docker compose logs -f
La base de dades de Weblate s’hauria de migrar automàticament al primer inici i no hi hauria de ser necessari fer accions manuals addicionals.
Nota
Les actualitzacions directes només s’admeten per a versions de l’any natural actual o anterior. Si necessiteu actualitzar des d’una versió anterior, actualitzeu primer a una versió intermèdia que apareix a Version-specific instructions.
If you use the example Compose files without local changes, you can also
review updates in the docker-compose repository, though this is not needed
for most Weblate upgrades. Customized Compose files need to be maintained as
part of your deployment. See Actualització del contenidor PostgreSQL for upgrading the
PostgreSQL server.
Actualització del contenidor PostgreSQL¶
Nota
PostgreSQL 18 va canviar el directori de dades predeterminat dins del contenidor. Una configuració antiga comuna va muntar el volum de la base de dades a /var/lib/postgresql/data, mentre que PostgreSQL 18 ara utilitza /var/lib/postgresql per defecte.
Si esteu actualitzant des d’una versió anterior, actualitzeu l’objectiu de muntatge a la configuració de Docker al camí nou, o bé manteniu l’antic objectiu de muntatge i configureu PGDATA en conseqüència.
Deixar l’antic objectiu de muntatge sense canviar sense establir PGDATA pot fer que PostgreSQL escrigui les seves dades fora del volum persistent.
Vegeu la documentació de PGDATA per obtenir més informació.
Els contenidors de PostgreSQL no admeten l’actualització automàtica entre les versions, cal que feu l’actualització manualment. Els passos següents mostren una de les opcions d’actualització.
Stop Weblate container:
docker compose stop weblate cache
Còpia de seguretat de la base de dades:
docker compose exec database pg_dumpall --clean --if-exists --username weblate > backup.sql
Atura el contenidor de la base de dades:
docker compose stop database
Remove the PostgreSQL volume:
docker compose rm -v database docker volume remove weblate-docker_postgres-data
Suggeriment
El nom del volum conté el nom del projecte Docker Compose, que és per defecte el nom del directori que és
weblate-dockeren aquesta documentació.Ajusteu
docker-compose.ymlper utilitzar la nova versió de PostgreSQL.Inicieu el contenidor de la base de dades:
docker compose up -d database
Restaura la base de dades des de la còpia de seguretat:
cat backup.sql | docker compose exec -T database psql --username weblate --dbname weblate
Suggeriment
Comproveu que el nom de la base de dades coincideixi amb
POSTGRES_DB.(Opcional) Actualitza la contrasenya per a l’usuari de Weblate. Això pot ser necessari quan es migra a PostgreSQL 14 o 15, ja que s’ha canviat la manera d’emmagatzemar les contrasenyes:
docker compose exec -T database psql --username weblate --dbname weblate -c "ALTER USER weblate WITH PASSWORD 'weblate'"
Suggeriment
Comproveu que el nom de la base de dades coincideixi amb
POSTGRES_DB.Start all remaining containers:
docker compose up -d
Admin sign in¶
Després de la configuració del contenidor, podeu iniciar la sessió com a usuari admin amb la contrasenya proporcionada a WEBLATE_ADMIN_PASSWORD, o una contrasenya aleatòria generada al primer inici si no s’ha establert.
Per restablir la contrasenya admin, reinicieu el contenidor amb WEBLATE_ADMIN_PASSWORD establert a la contrasenya nova.
Nombre de processos i consum de memòria¶
The number of worker processes for both the web application and Celery is determined automatically based on number of CPUs. This works well for most cloud virtual machines as these typically have few CPUs and good amount of memory.
By default, one combined Celery worker handles all task queues using a prefork
pool with three times WEBLATE_WORKERS processes. Sharing the initial
application memory between all Celery workers reduces memory usage while the
higher process count increases task throughput.
En cas que tingueu molts nuclis de CPU i us quedeu sense problemes de memòria, proveu de reduir el nombre de treballadors:
environment:
WEBLATE_WORKERS: 2
You can fine-tune the combined worker:
environment:
CELERY_COMBINED_OPTIONS: --concurrency 12 --prefetch-multiplier 1
Alternatively, use the split mode to run and fine-tune individual worker categories:
environment:
CELERY_WORKER_MODE: split
WEB_WORKERS: 4
WEB_BLOCKING_THREADS: 4
CELERY_MAIN_OPTIONS: --concurrency 2 --prefetch-multiplier 1
CELERY_NOTIFY_OPTIONS: --concurrency 1 --prefetch-multiplier 4
CELERY_MEMORY_OPTIONS: --concurrency 1 --prefetch-multiplier 1
CELERY_TRANSLATE_OPTIONS: --concurrency 1 --prefetch-multiplier 1
CELERY_BACKUP_OPTIONS: --concurrency 1 --prefetch-multiplier 1
The prefetch multiplier controls how many tasks each worker execution slot can reserve. The default of one avoids reserving additional long-running or payload-heavy tasks. The notification worker uses four in this example because its short tasks can benefit from buffering. Increase the value only after measuring queue latency and worker memory usage.
Memory usage can be further reduced by running Celery in a single process:
environment:
CELERY_WORKER_MODE: single
Escala horitzontal¶
Afegit a la versió 4.6.
Podeu executar diversos contenidors de Weblate per escalar el servei horitzontalment. El volum /app/data ha de ser compartit per tots els contenidors, es recomana utilitzar un sistema de fitxers de clúster com GlusterFS per a això. El volum /app/cache hauria de ser independent per a cada contenidor.
Cada contenidor de Weblate té un rol definit mitjançant la variable d’entorn WEBLATE_SERVICE. Si us plau, seguiu atentament la documentació, ja que alguns dels serveis haurien d’executar-se només una vegada al clúster, i l’ordre dels serveis també és important.
Podeu trobar un exemple de configuració al repo docker-compose com a docker-compose-split.yml.
Startup configuration warnings¶
The Docker container records actionable configuration warnings from startup
in the shared /app/data volume. They are shown by
weblate check --deploy and in the Informe de rendiment
management interface, in addition to being written to the container log.
Each container reports its warnings separately. This keeps warnings from
containers with different WEBLATE_SERVICE roles visible in a
horizontally scaled deployment. Reports are refreshed while their container is
running and are removed during an orderly container shutdown. Reports left by
an abrupt shutdown expire after five minutes, and stale report files are
cleaned up automatically by later container startups.
Variables d’entorn de Docker¶
Molts dels Configuration de Weblate es poden configurar al contenidor Docker mitjançant les variables d’entorn que es descriuen a continuació.
Si necessiteu definir una configuració no exposada mitjançant les variables d’entorn de Docker, consulteu Configuration beyond environment variables.
Passing secrets¶
Afegit a la versió 5.0.
El contenidor Weblate admet la transmissió de secrets com a fitxers. Per utilitzar-ho, afegiu el sufix _FILE a la variable d’entorn i passeu el fitxer secret mitjançant Docker.
Relacionat docker-compose.yml pot semblar:
services:
weblate:
environment:
POSTGRES_PASSWORD_FILE: /run/secrets/db_password
secrets:
- db_password
database:
environment:
POSTGRES_PASSWORD_FILE: /run/secrets/db_password
secrets:
- db_password
secrets:
db_password:
file: db_password.txt
Vegeu també
Configuració genèrica¶
- WEBLATE_SECRET_KEY¶
Afegit a la versió 2026.12.
Configures Django’s
SECRET_KEY. You can provide the key directly or useWEBLATE_SECRET_KEY_FILEto read it from a mounted secret file:environment: WEBLATE_SECRET_KEY_FILE: /run/secrets/weblate_secret_key
The file variant takes precedence over the direct value. If the resolved key is empty or neither variable is configured, Weblate reads
/app/data/secret. An unreadable file configured throughWEBLATE_SECRET_KEY_FILEcauses a configuration error.Keep the key stable across container restarts and use the same key for all containers in the deployment to preserve sessions and signed links.
Vegeu també
- WEBLATE_DEBUG¶
Configura el mode de depuració de Django mitjançant
DEBUG.Exemple:
environment: WEBLATE_DEBUG: 1
Vegeu també
- WEBLATE_LOGLEVEL¶
Configura la verbositat del registre. Estableix-ho a
DEBUGper obtenir registres més detallats.El valor per defecte és
INFOquanWEBLATE_DEBUGestà desactivat,DEBUGs’utilitza quan el mode de depuració està activat.Per a un registre més silenciós, utilitzeu
ERRORoWARNING.
- WEBLATE_LOGLEVEL_DATABASE¶
Configura el registre de la verbositat de les consultes de la base de dades.
- WEBLATE_LOG_GELF_HOST¶
Afegit a la versió 5.9.
Configura el registre remot mitjançant la connexió GELF TCP. Es pot utilitzar per integrar-se amb Graylog.
- WEBLATE_LOG_GELF_PORT¶
Afegit a la versió 5.9.
Utilitzeu el port personalitzat per a
WEBLATE_LOG_GELF_HOST, el valor predeterminat és 12201.
- WEBLATE_SITE_TITLE¶
Canvia el títol del lloc que es mostra a la capçalera de totes les pàgines.
- WEBLATE_SITE_DOMAIN¶
Configures the site domain. This parameter is required and accepts a hostname or IPv4 address.
Include a port between 1 and 65535 if using a non-standard one. IPv6 addresses are not currently supported.
Exemple:
environment: WEBLATE_SITE_DOMAIN: example.com:8080
Vegeu també
- WEBLATE_ADMIN_NAME¶
- WEBLATE_ADMIN_EMAIL¶
Configura el nom i el correu electrònic de l’administrador del lloc. S’utilitza tant per a la configuració de
ADMINScom per crear un usuari admin (vegeuWEBLATE_ADMIN_PASSWORDper obtenir més informació al respecte).Exemple:
environment: WEBLATE_ADMIN_NAME: Weblate admin WEBLATE_ADMIN_EMAIL: noreply@example.com
- WEBLATE_ADMIN_PASSWORD¶
Estableix la contrasenya per a l’usuari admin.
Si no s’estableix i l’usuari admin no existeix, es crea amb una contrasenya aleatòria que es mostra a l’inici del primer contenidor.
Si no es defineix i existeix l’usuari admin, no es realitza cap acció.
Si s’estableix, l’usuari admin s’ajusta a l’inici de cada contenidor perquè coincideixi amb
WEBLATE_ADMIN_PASSWORD,WEBLATE_ADMIN_NAMEiWEBLATE_ADMIN_EMAIL.
Avís
Pot ser un risc per a la seguretat emmagatzemar la contrasenya al fitxer de configuració. Penseu en utilitzar aquesta variable només per a la configuració inicial (o deixeu que Weblate generi una contrasenya aleatòria a l’inici inicial) o per a la recuperació de la contrasenya.
- WEBLATE_ADMIN_NOTIFY_ERROR¶
Si s’ha d’enviar correu electrònic als administradors en cas d’error del servidor. Activat per defecte.
És possible que vulgueu utilitzar una altra col·lecció d’errors com Sentry o Rollbar i desactivar-ho.
Vegeu també
- WEBLATE_SERVER_EMAIL¶
L’adreça de correu electrònic des de la qual s’envien els missatges d’error.
- WEBLATE_DEFAULT_FROM_EMAIL¶
Configura l’adreça per als correus electrònics de sortida.
- WEBLATE_ADMINS_CONTACT¶
Configura
ADMINS_CONTACT.
- WEBLATE_CONTACT_FORM¶
Configura el comportament del formulari de contacte, vegeu
CONTACT_FORM.
- WEBLATE_ALLOWED_HOSTS¶
Configura els noms d’amfitrió HTTP permesos mitjançant
ALLOWED_HOSTS.El valor per defecte és
*que permet tots els noms d’amfitrió.Exemple:
environment: WEBLATE_ALLOWED_HOSTS: weblate.example.com,example.com
- WEBLATE_REGISTRATION_OPEN¶
Configura si els registres estan oberts canviant
REGISTRATION_OPEN.Exemple:
environment: WEBLATE_REGISTRATION_OPEN: 0
- WEBLATE_REGISTRATION_CAPTCHA¶
Afegit a la versió 5.10.
Configura si s’utilitza captcha per al registre i altres accions no autenticades, vegeu
REGISTRATION_CAPTCHA.Exemple:
environment: WEBLATE_REGISTRATION_CAPTCHA: 0
- WEBLATE_REGISTRATION_ALLOW_BACKENDS¶
Configura quins mètodes d’autenticació es poden utilitzar per crear un compte nou mitjançant
REGISTRATION_ALLOW_BACKENDS.Exemple:
environment: WEBLATE_REGISTRATION_OPEN: 0 WEBLATE_REGISTRATION_ALLOW_BACKENDS: azuread-oauth2,azuread-tenant-oauth2
- WEBLATE_REGISTRATION_REBIND¶
Afegit a la versió 4.16.
Configura
REGISTRATION_REBIND.
- WEBLATE_REGISTRATION_ALLOW_DISPOSABLE_EMAILS¶
Afegit a la versió 5.16.1.
Configures
REGISTRATION_ALLOW_DISPOSABLE_EMAILS.Exemple:
environment: WEBLATE_REGISTRATION_ALLOW_DISPOSABLE_EMAILS: 1
- WEBLATE_PROJECT_WEB_RESTRICT_PRIVATE¶
Afegit a la versió 5.17.
Configures
PROJECT_WEB_RESTRICT_PRIVATE.Defaults to enabled.
- WEBLATE_PROJECT_WEB_RESTRICT_ALLOWLIST¶
Afegit a la versió 5.17.
Configures
PROJECT_WEB_RESTRICT_ALLOWLIST.S’espera una llista separada per comes de slugs de projecte de confiança.
- WEBLATE_WEBHOOK_RESTRICT_PRIVATE¶
Afegit a la versió 5.17.
Configures
WEBHOOK_RESTRICT_PRIVATE.Defaults to enabled.
- WEBLATE_WEBHOOK_PRIVATE_ALLOWLIST¶
Afegit a la versió 5.17.
Configures
WEBHOOK_PRIVATE_ALLOWLIST.S’espera una llista separada per comes de noms d’amfitrió o dominis de confiança.
- WEBLATE_ALLOWED_ASSET_SIZE¶
Afegit a la versió 2025.7.
Configures
ALLOWED_ASSET_SIZE.
- WEBLATE_ASSET_RESTRICT_PRIVATE¶
Afegit a la versió 2025.5.
Configures
ASSET_RESTRICT_PRIVATE.Defaults to enabled.
- WEBLATE_ASSET_PRIVATE_ALLOWLIST¶
Afegit a la versió 2025.5.
Configures
ASSET_PRIVATE_ALLOWLIST.S’espera una llista separada per comes de noms d’amfitrió o dominis de confiança.
- WEBLATE_TIME_ZONE¶
Configura la zona horària utilitzada a Weblate, vegeu
TIME_ZONE.Nota
Per canviar la zona horària del propi contenidor Docker, utilitzeu la variable d’entorn
TZ.Exemple:
environment: WEBLATE_TIME_ZONE: Europe/Prague
- WEBLATE_ENABLE_HTTPS¶
Fa que Weblate assumeixi que funciona darrere d’un servidor intermediari HTTPS invers, fa que Weblate utilitzi HTTPS als enllaços de correu electrònic i API o estableixi senyals segurs a les galetes.
Suggeriment
Si us plau, consulteu la documentació de
ENABLE_HTTPSper a possibles advertències.Nota
Això no fa que el contenidor Weblate accepti connexions HTTPS, cal que també ho configureu, vegeu Contenidor Docker amb suport HTTPS per exemples.
Exemple:
environment: WEBLATE_ENABLE_HTTPS: 1
- WEBLATE_NGINX_IPV6¶
Afegit a la versió 5.17.
Controla si el paquet NGINX escolta a les adreces IPv6.
Supported values are:
autoper habilitar els oients IPv6 només quan IPv6 està disponible al temps d’execució del contenidor. Aquesta és la predeterminada.activatper habilitar sempre els oients IPv6.offper desactivar els oients IPv6.
Exemple:
environment: WEBLATE_NGINX_IPV6: auto
- WEBLATE_IP_PROXY_HEADER¶
Permet a Weblate obtenir l’adreça IP de qualsevol capçalera HTTP determinada. Utilitzeu-ho quan utilitzeu un servidor intermediari invers davant del contenidor Weblate.
Habilita
IP_BEHIND_REVERSE_PROXYi estableixIP_PROXY_HEADER.When set to
HTTP_X_FORWARDED_FOR, the bundled nginx resolves the client address usingWEBLATE_TRUSTED_PROXY_ADDRESSES, uses that address in its logs, and forwards one normalized address to Weblate.Canviat a la versió 2026.9: The bundled nginx no longer trusts
X-Forwarded-Forfrom all network addresses. Trusted proxy addresses have to be configured explicitly.Nota
El format ha d’ajustar-se a les expectatives de Django. Django transforma els noms de capçalera HTTP en brut de la manera següent:
converteix tots els caràcters a majúscules
substitueix qualsevol guionet per guions baixos
anteposa el prefix
HTTP_
Així que
X-Forwarded-Fors’assignaria aHTTP_X_FORWARDED_FOR.Exemple:
environment: WEBLATE_IP_PROXY_HEADER: HTTP_X_FORWARDED_FOR WEBLATE_TRUSTED_PROXY_ADDRESSES: "192.0.2.10 2001:db8::/64 proxy"
- WEBLATE_TRUSTED_PROXY_ADDRESSES¶
Afegit a la versió 2026.9.
Configures the IPv4 or IPv6 addresses, networks, or hostnames of reverse proxies trusted by the bundled nginx to supply
X-Forwarded-For. Separate multiple values by whitespace.This setting is used only when
WEBLATE_IP_PROXY_HEADERisHTTP_X_FORWARDED_FOR. If the list is empty, nginx uses the immediate TCP peer in its logs and forwards that address to Weblate.Only list proxies under your control, and do not expose the Weblate container through a path which bypasses them.
Exemple:
environment: WEBLATE_IP_PROXY_HEADER: HTTP_X_FORWARDED_FOR WEBLATE_TRUSTED_PROXY_ADDRESSES: "192.0.2.10 2001:db8::/64 proxy"
- WEBLATE_IP_PROXY_OFFSET¶
Afegit a la versió 5.0.1.
Configura
IP_PROXY_OFFSET.When
WEBLATE_IP_PROXY_HEADERisHTTP_X_FORWARDED_FOR, the bundled nginx forwards one normalized address and the container uses an effective offset of0.
- WEBLATE_USE_X_FORWARDED_PORT¶
Afegit a la versió 5.0.1.
Un booleà que especifica si s’ha d’utilitzar la capçalera X-Forwarded-Port amb preferència a la variable META SERVER_PORT. Això només s’hauria d’habilitar si s’utilitza un servidor intermediari que defineix aquesta capçalera.
Vegeu també
Nota
Aquesta és una configuració booleana (utilitza
"true"o"false").
- WEBLATE_SECURE_PROXY_SSL_HEADER¶
Una tupla que representa una combinació de capçalera/valor HTTP que indica que una sol·licitud és segura. Això és necessari quan Weblate s’executa darrere d’un servidor intermediari invers que fa la terminació SSL que no passa capçaleres HTTPS estàndard.
Exemple:
environment: WEBLATE_SECURE_PROXY_SSL_HEADER: HTTP_X_FORWARDED_PROTO,https
- WEBLATE_REQUIRE_LOGIN¶
Habilita
REQUIRE_LOGINper imposar l’autenticació a tot el Weblate.Exemple:
environment: WEBLATE_REQUIRE_LOGIN: 1
- WEBLATE_LEGAL_INTEGRATION¶
Habilita el mòdul Legal module als desplegaments de Docker. Per defecte, la integració està desactivada; deixa aquesta variable sense definir o buida per desactivar-la.
Supported values are:
tos-confirmto enable the legal module and enforce legal document confirmation during social authentication and for signed-in users.wllegalper habilitar la mateixa integració i, addicionalment, carregar les plantilles de documents legals allotjades des dewllegal. Aquestes plantilles les fan servir els serveis operats per Weblate s.r.o. i no estan destinats a un ús general.
Per proporcionar els vostres propis documents legals a Docker, substituïu les plantilles a
/app/data/python/customize/templates/legal/documents, consulteu Substitució del logotip i altres fitxers estàtics.Torneu a crear el contenidor Docker després de canviar aquesta variable d’entorn, per exemple utilitzant docker compose up -d. El reinici d’un contenidor existent no aplica els valors d’entorn modificats.
Exemple:
environment: WEBLATE_LEGAL_INTEGRATION: tos-confirm
- WEBLATE_LEGAL_DOCUMENT_CSS_CLASS¶
Configura
LEGAL_DOCUMENT_CSS_CLASSals desplegaments de Docker ambWEBLATE_LEGAL_INTEGRATIONactivat.Set this to the class targeted by your custom legal stylesheet. Set it to an empty string to render legal documents without a wrapper class.
Exemple:
environment: WEBLATE_LEGAL_DOCUMENT_CSS_CLASS: ""
- WEBLATE_LEGAL_HIDDEN_DOCUMENTS¶
Configura
LEGAL_HIDDEN_DOCUMENTSals desplegaments de Docker ambWEBLATE_LEGAL_INTEGRATIONactivat.Proporcioneu una llista separada per comes d’identificadors de pàgines de documents legals.
External legal document URLs take priority over internal page links. The following configuration hides the internal pages, links both documents externally, and requires one agreement covering both:
Exemple:
environment: WEBLATE_LEGAL_INTEGRATION: tos-confirm WEBLATE_LEGAL_HIDDEN_DOCUMENTS: terms,privacy WEBLATE_LEGAL_URL: https://example.com/terms/ WEBLATE_PRIVACY_URL: https://example.com/privacy/
- WEBLATE_PUBLIC_ENGAGE¶
Enables
PUBLIC_ENGAGE.
- WEBLATE_GOOGLE_ANALYTICS_ID¶
Configura l’identificador de Google Analytics canviant
GOOGLE_ANALYTICS_ID.
- WEBLATE_DEFAULT_PULL_MESSAGE¶
Configura el títol i el missatge predeterminats per a les sol·licituds d’extracció mitjançant l’API canviant
DEFAULT_PULL_MESSAGE.Vegeu també
- WEBLATE_SIMPLIFY_LANGUAGES¶
Configura la política de simplificació lingüística, vegeu
SIMPLIFY_LANGUAGES.
- WEBLATE_HIDE_SHARED_GLOSSARY_COMPONENTS¶
Amaga els components del glossari quan es comparteix amb altres projectes, vegeu
HIDE_SHARED_GLOSSARY_COMPONENTS.
- WEBLATE_DEFAULT_ACCESS_CONTROL¶
Configura el valor predeterminat Control d’accés per a projectes nous, vegeu
DEFAULT_ACCESS_CONTROL.
- WEBLATE_DEFAULT_TRANSLATION_REVIEW¶
Afegit a la versió 5.16.
Configura el valor predeterminat per a Activa les revisions, desactivat per defecte.
- WEBLATE_DEFAULT_SOURCE_REVIEW¶
Afegit a la versió 5.16.
Configura el valor predeterminat per a Activa les revisions d’origen, desactivat per defecte.
- WEBLATE_DEFAULT_RESTRICTED_COMPONENT¶
Configura el valor predeterminat per a Accés restringit per als components nous, vegeu
DEFAULT_RESTRICTED_COMPONENT.
- WEBLATE_DEFAULT_TRANSLATION_PROPAGATION¶
Configura el valor predeterminat per a Permet la propagació de traduccions per als components nous, vegeu
DEFAULT_TRANSLATION_PROPAGATION.
- WEBLATE_DEFAULT_COMMITER_EMAIL¶
Configura
DEFAULT_COMMITER_EMAIL.
- WEBLATE_DEFAULT_COMMITER_NAME¶
Configura
DEFAULT_COMMITER_NAME.
- WEBLATE_DEFAULT_SHARED_TM¶
Configura
DEFAULT_SHARED_TM.
- WEBLATE_DEFAULT_WORKSPACE_TM¶
Configures
DEFAULT_WORKSPACE_TM.
- WEBLATE_DEFAULT_AUTOCLEAN_TM¶
Configures
DEFAULT_AUTOCLEAN_TM.
- WEBLATE_COMMIT_PENDING_HOURS¶
Configura el valor per defecte per a Antiguitat dels canvis a publicar per als components nous, vegeu
COMMIT_PENDING_HOURS.
- WEBLATE_GPG_IDENTITY¶
Configura la signatura GPG de commits, vegeu
WEBLATE_GPG_IDENTITY.Vegeu també
- WEBLATE_URL_PREFIX¶
Configures URL prefix where Weblate is running, see
URL_PREFIX. Leave it empty to serve Weblate at the root, or use slash-separated path segments starting with a slash, for example/translationsor/tools/translations. Each segment can contain ASCII letters, digits,_, and-.
- WEBLATE_SILENCED_SYSTEM_CHECKS¶
Configura comprovacions que no voleu que es mostrin, vegeu
SILENCED_SYSTEM_CHECKS.
- WEBLATE_CSP_SCRIPT_SRC¶
- WEBLATE_CSP_IMG_SRC¶
- WEBLATE_CSP_CONNECT_SRC¶
- WEBLATE_CSP_STYLE_SRC¶
- WEBLATE_CSP_FONT_SRC¶
- WEBLATE_CSP_FORM_SRC¶
Permet personalitzar la capçalera HTTP Content-Security-Policy.
- WEBLATE_LICENSE_FILTER¶
Configura
LICENSE_FILTER.
- WEBLATE_LICENSE_REQUIRED¶
Configura
LICENSE_REQUIRED.
- WEBLATE_WEBSITE_REQUIRED¶
Configura
WEBSITE_REQUIRED.
- WEBLATE_VERSION_DISPLAY¶
Configures
VERSION_DISPLAY.
- WEBLATE_HIDE_VERSION¶
Configura
HIDE_VERSION.
- WEBLATE_BASIC_LANGUAGES¶
Configura
BASIC_LANGUAGES.
- WEBLATE_DEFAULT_AUTO_WATCH¶
Configura
DEFAULT_AUTO_WATCH.
- WEBLATE_DEFAULT_NOTIFICATIONS¶
Afegit a la versió 2026.10.1.
Configures
DEFAULT_NOTIFICATIONS.Exemple:
environment: WEBLATE_DEFAULT_NOTIFICATIONS: 0:1:MentionCommentNotificaton,10:1:LastAuthorCommentNotificaton
- WEBLATE_RATELIMIT_ATTEMPTS¶
- WEBLATE_RATELIMIT_LOCKOUT¶
- WEBLATE_RATELIMIT_WINDOW¶
- WEBLATE_RATELIMIT_OCR_ATTEMPTS¶
- WEBLATE_RATELIMIT_OCR_WINDOW¶
- WEBLATE_RATELIMIT_OCR_LOCKOUT¶
- WEBLATE_RATELIMIT_BULK_EDIT_ATTEMPTS¶
- WEBLATE_RATELIMIT_BULK_EDIT_WINDOW¶
- WEBLATE_RATELIMIT_BULK_EDIT_LOCKOUT¶
- WEBLATE_RATELIMIT_UPLOAD_ATTEMPTS¶
- WEBLATE_RATELIMIT_UPLOAD_WINDOW¶
- WEBLATE_RATELIMIT_UPLOAD_LOCKOUT¶
- WEBLATE_RATELIMIT_MACHINERY_ATTEMPTS¶
- WEBLATE_RATELIMIT_MACHINERY_WINDOW¶
- WEBLATE_RATELIMIT_MACHINERY_LOCKOUT¶
Afegit a la versió 4.6.
Configures rate limiter.
Suggeriment
Podeu configurar la configuració per a qualsevol àmbit de limitació de velocitat. Per fer-ho, afegiu el prefix
WEBLATE_a qualsevol dels paràmetres descrits a Limitació de tarifes.Vegeu també
- WEBLATE_API_RATELIMIT_ANON¶
- WEBLATE_API_RATELIMIT_USER¶
Afegit a la versió 4.11.
Configures
API_RATELIMIT_ANONandAPI_RATELIMIT_USER. Defaults to100/dayfor anonymous and5000/hourfor authenticated users.Vegeu també
- WEBLATE_API_RATELIMIT_USER_OVERRIDES¶
- WEBLATE_API_RATELIMIT_IP_OVERRIDES¶
Afegit a la versió 2026.10.
JSON mappings configuring
API_RATELIMIT_USER_OVERRIDESandAPI_RATELIMIT_IP_OVERRIDES. Both default to empty objects. Use JSONnullto exempt a user, IP address, or network from API throttling.For example, in
compose.override.yaml:services: weblate: environment: WEBLATE_API_RATELIMIT_USER_OVERRIDES: '{"automation":"20000/hour"}' WEBLATE_API_RATELIMIT_IP_OVERRIDES: '{"192.0.2.42":null,"198.51.100.0/24":"10000/hour"}'
Username rules take precedence over IP rules. See Limitació de velocitat de l’API for counting behavior and proxy configuration requirements.
- WEBLATE_ENABLE_HOOKS¶
Afegit a la versió 4.13.
Configura
ENABLE_HOOKS.
- WEBLATE_ENABLE_AVATARS¶
Afegit a la versió 4.6.1.
Configura
ENABLE_AVATARS.
- WEBLATE_AVATAR_URL_PREFIX¶
Afegit a la versió 4.15.
Configura
AVATAR_URL_PREFIX.
- WEBLATE_AVATAR_URL_TEMPLATE¶
Afegit a la versió 2026.10.
Configures
AVATAR_URL_TEMPLATE.
- WEBLATE_LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶
Afegit a la versió 4.9.
Configura
LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH.
- WEBLATE_SSH_EXTRA_ARGS¶
Afegit a la versió 4.9.
Configura
SSH_EXTRA_ARGS.
- WEBLATE_BORG_EXTRA_ARGS¶
Afegit a la versió 4.9.
Configura
BORG_EXTRA_ARGScom una llista d’args separada per comes.Exemple:
environment: WEBLATE_BORG_EXTRA_ARGS: --exclude,vcs/
- WEBLATE_ENABLE_SHARING¶
Afegit a la versió 4.14.1.
Configura
ENABLE_SHARING.
- WEBLATE_SUPPORT_STATUS_CHECK¶
Afegit a la versió 5.5.
Configura
SUPPORT_STATUS_CHECK.
- WEBLATE_EXTRA_HTML_HEAD¶
Afegit a la versió 4.15.
Configura
EXTRA_HTML_HEAD.
- WEBLATE_INTERNAL_BOT_EMAIL_TEMPLATE¶
Afegit a la versió 2026.7.1.
Configures
INTERNAL_BOT_EMAIL_TEMPLATE.
- WEBLATE_PRIVATE_COMMIT_EMAIL_TEMPLATE¶
Afegit a la versió 4.15.
Configura
PRIVATE_COMMIT_EMAIL_TEMPLATE.Vegeu també
- WEBLATE_PRIVATE_COMMIT_EMAIL_OPT_IN¶
Afegit a la versió 4.15.
Configura
PRIVATE_COMMIT_EMAIL_OPT_IN.Vegeu també
- WEBLATE_PRIVATE_COMMIT_NAME_TEMPLATE¶
Afegit a la versió 5.16.
Configures
PRIVATE_COMMIT_NAME_TEMPLATE.Vegeu també
- WEBLATE_PRIVATE_COMMIT_NAME_OPT_IN¶
Afegit a la versió 5.16.
Configures
PRIVATE_COMMIT_NAME_OPT_IN.Vegeu també
To use private commit e-mails and names by default, set both opt-in variables to
Falseindocker-compose.override.yml:services: weblate: environment: WEBLATE_PRIVATE_COMMIT_EMAIL_OPT_IN: "False" WEBLATE_PRIVATE_COMMIT_NAME_OPT_IN: "False"
The default templates use the user ID for both the private e-mail and name. The template variables are optional customizations. Setting the templates alone leaves private commit identities opt-in.
These defaults apply to new and existing users without explicit commit identity choices. Users can still select their account identity. Existing commits are unchanged.
After changing the environment, run
docker compose up -dto recreate the affected containers. Apply the same configuration to separately deployed workers so both web and worker processes use the new defaults.
- WEBLATE_UNUSED_ALERT_DAYS¶
Afegit a la versió 4.17.
Configura
UNUSED_ALERT_DAYS.
- WEBLATE_REPORT_EXPIRY¶
Afegit a la versió 2026.8.
Configures
REPORT_EXPIRY.
- WEBLATE_UPDATE_LANGUAGES¶
Afegit a la versió 4.3.2.
Configura
UPDATE_LANGUAGES.
- WEBLATE_VCS_ALLOW_HOSTS¶
Afegit a la versió 5.15.
Configures
VCS_ALLOW_HOSTS.
- WEBLATE_VCS_PRIVATE_ALLOWLIST¶
Afegit a la versió 2026.9.
Configures
VCS_PRIVATE_ALLOWLIST.
- WEBLATE_VCS_ALLOW_SCHEMES¶
Afegit a la versió 5.15.
Configures
VCS_ALLOW_SCHEMES.The
filescheme is disabled for security reasons. Including it prevents Weblate from starting.
- WEBLATE_VCS_RESTRICT_PRIVATE¶
Afegit a la versió 5.17.
Configures
VCS_RESTRICT_PRIVATE.
- WEBLATE_VCS_CLONE_DEPTH¶
Afegit a la versió 5.4.
Configures
VCS_CLONE_DEPTH.
- WEBLATE_VCS_API_DELAY¶
Afegit a la versió 5.4.
Configures
VCS_API_DELAY.
- WEBLATE_VCS_API_TIMEOUT¶
Afegit a la versió 5.15.
Configures
VCS_API_TIMEOUT.
- WEBLATE_CORS_ALLOWED_ORIGINS¶
Afegit a la versió 4.16.
Permet sol·licituds CORS a l’API des d’orígens determinats.
Exemple:
environment: WEBLATE_CORS_ALLOWED_ORIGINS: https://example.com,https://weblate.org
- WEBLATE_CORS_ALLOW_ALL_ORIGINS¶
Afegit a la versió 5.6.1: Permet sol·licituds CORS a l’API des de tots els orígens.
- WEBLATE_WEBSITE_ALERTS_ENABLED¶
Afegit a la versió 5.17.
Configures
WEBSITE_ALERTS_ENABLED.
- CLIENT_MAX_BODY_SIZE¶
Afegit a la versió 4.16.3.
Configures maximal body size accepted by the built-in web server. Use a non-negative integer with an optional
k,m, orgsuffix. The suffix is case-insensitive, and0disables the request body size limit.environment: CLIENT_MAX_BODY_SIZE: 200m
Suggeriment
Aquesta variable no té intencionadament el prefix
WEBLATE_ja que es comparteix amb un contenidor de tercers utilitzat a Certificats SSL automàtics mitjançant Let’s Encrypt.
- WEBLATE_TRANSLATION_MAX_SIZE¶
Configures
TRANSLATION_MAX_SIZEin bytes. When unset, followsWEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.
- WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE¶
Configures
TRANSLATION_UPLOAD_MAX_SIZE.The value is in bytes.
- WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE¶
Configures
COMPONENT_ZIP_UPLOAD_MAX_SIZE.The value is in bytes.
- WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE¶
Configures
PROJECT_BACKUP_UPLOAD_MAX_SIZE.El valor està en bytes. Assegureu-vos que
CLIENT_MAX_BODY_SIZEtambé sigui prou gran per als fitxers de còpia de seguretat penjats.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS¶
Afegit a la versió 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MAX_MEMBERS.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE¶
Afegit a la versió 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE.The value is in bytes.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE¶
Afegit a la versió 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE.The value is in bytes.
- WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE¶
Afegit a la versió 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE.The value is in bytes.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO¶
Afegit a la versió 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO.
Code-hosting sites credentials¶
In the Docker container, the code-hosting credentials can be configured either in separate variables or using a Python dictionary to set them at once. The following examples are for GitHub pull requests, but apply to all Integració del control de versions with appropriately changed variable names.
Important
Tots els noms de variables d’entorn han d’incloure el prefix WEBLATE_. Per exemple, per configurar les credencials de GitHub, utilitzeu WEBLATE_GITHUB_USERNAME, no GITHUB_USERNAME. Això s’aplica tant si esteu configurant per a sol·licituds d’extracció com per a qualsevol altra integració de VCS.
Un exemple de configuració per a les sol·licituds d’extracció de GitHub podria semblar:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
S’utilitzarà com a:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
Alternativament, el diccionari de Python es pot proporcionar com una cadena:
WEBLATE_GITHUB_CREDENTIALS='{ "api.github.com": { "username": "api-user", "token": "api-token", } }'
Or the path to a file containing the Python dictionary:
echo '{ "api.github.com": { "username": "api-user", "token": "api-token", } }' > /path/to/github-credentials
WEBLATE_GITHUB_CREDENTIALS_FILE='/path/to/github-credentials'
- WEBLATE_GITHUB_USERNAME¶
- WEBLATE_GITHUB_TOKEN¶
- WEBLATE_GITHUB_HOST¶
- WEBLATE_GITHUB_CREDENTIALS¶
Configura GitHub pull requests canviant
GITHUB_CREDENTIALS.Vegeu també
- WEBLATE_GITHUB_LEGACY_APP_WEBHOOK_SECRET¶
Afegit a la versió 2026.8.
Configures
GITHUB_LEGACY_APP_WEBHOOK_SECRET. The_FILEvariant can be used to load the secret from a file.
GitHub Apps registered through the in-app manifest flow are stored in the database and do not need environment variables. See GitHub notifications.
- WEBLATE_GITLAB_USERNAME¶
- WEBLATE_GITLAB_TOKEN¶
- WEBLATE_GITLAB_HOST¶
- WEBLATE_GITLAB_CREDENTIALS¶
Configura GitLab merge requests canviant
GITLAB_CREDENTIALS.Vegeu també
- WEBLATE_GITEA_USERNAME¶
- WEBLATE_GITEA_TOKEN¶
- WEBLATE_GITEA_HOST¶
- WEBLATE_GITEA_CREDENTIALS¶
Configura Gitea pull requests canviant
GITEA_CREDENTIALS.Vegeu també
- WEBLATE_PAGURE_USERNAME¶
- WEBLATE_PAGURE_TOKEN¶
- WEBLATE_PAGURE_HOST¶
- WEBLATE_PAGURE_CREDENTIALS¶
Configura Pagure merge requests canviant
PAGURE_CREDENTIALS.Vegeu també
- WEBLATE_BITBUCKETSERVER_USERNAME¶
- WEBLATE_BITBUCKETSERVER_TOKEN¶
- WEBLATE_BITBUCKETSERVER_HOST¶
- WEBLATE_BITBUCKETSERVER_CREDENTIALS¶
Configura Bitbucket Data Center pull requests canviant
BITBUCKETSERVER_CREDENTIALS.
- WEBLATE_BITBUCKETCLOUD_USERNAME¶
- WEBLATE_BITBUCKETCLOUD_WORKSPACE¶
- WEBLATE_BITBUCKETCLOUD_TOKEN¶
- WEBLATE_BITBUCKETCLOUD_HOST¶
- WEBLATE_BITBUCKETCLOUD_CREDENTIALS¶
Configura Bitbucket Cloud pull requests canviant
BITBUCKETCLOUD_CREDENTIALS.Vegeu també
- WEBLATE_AZURE_DEVOPS_USERNAME¶
- WEBLATE_AZURE_DEVOPS_ORGANIZATION¶
- WEBLATE_AZURE_DEVOPS_TOKEN¶
- WEBLATE_AZURE_DEVOPS_HOST¶
- WEBLATE_AZURE_DEVOPS_CREDENTIALS¶
Configura Azure DevOps pull requests canviant
AZURE_DEVOPS_CREDENTIALS.Vegeu també
Translation services settings¶
Canviat a la versió 4.13: Translation services are now configured in the user interface, see Serveis de traducció.
Les variables d’entorn existents s’importen durant la migració a Weblate 4.13, però canviar-les no tindrà cap efecte més.
Configuració d’autenticació¶
Suggeriment
L’autenticació basada en correu electrònic està activada tret que estigui desactivada per WEBLATE_NO_EMAIL_AUTH.
LDAP¶
- WEBLATE_AUTH_LDAP_SERVER_URI¶
- WEBLATE_AUTH_LDAP_USER_DN_TEMPLATE¶
- WEBLATE_AUTH_LDAP_USER_ATTR_MAP¶
- WEBLATE_AUTH_LDAP_BIND_DN¶
- WEBLATE_AUTH_LDAP_BIND_PASSWORD¶
- WEBLATE_AUTH_LDAP_CONNECTION_OPTION_REFERRALS¶
- WEBLATE_AUTH_LDAP_USER_SEARCH¶
- WEBLATE_AUTH_LDAP_USER_SEARCH_FILTER¶
- WEBLATE_AUTH_LDAP_USER_SEARCH_UNION¶
- WEBLATE_AUTH_LDAP_USER_SEARCH_UNION_DELIMITER¶
Configuració d’autenticació LDAP.
Exemple d’enllaç directe:
environment: WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_USER_DN_TEMPLATE: uid=%(user)s,ou=People,dc=example,dc=net # map weblate 'full_name' to ldap 'name' and weblate 'email' attribute to 'mail' ldap attribute. # another example that can be used with OpenLDAP: 'full_name:cn,email:mail' WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail
Exemple de cerca i enllaç:
environment: WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_BIND_PASSWORD: password WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail WEBLATE_AUTH_LDAP_USER_SEARCH: CN=Users,DC=example,DC=com
Exemple de cerca i enllaç d’unions:
environment: WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_BIND_PASSWORD: password WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail WEBLATE_AUTH_LDAP_USER_SEARCH_UNION: ou=users,dc=example,dc=com|ou=otherusers,dc=example,dc=com
Exemple amb cerca i vinculació amb Active Directory:
environment: WEBLATE_AUTH_LDAP_BIND_DN: CN=ldap,CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_BIND_PASSWORD: password WEBLATE_AUTH_LDAP_SERVER_URI: ldap://ldap.example.org WEBLATE_AUTH_LDAP_CONNECTION_OPTION_REFERRALS: 0 WEBLATE_AUTH_LDAP_USER_ATTR_MAP: full_name:name,email:mail WEBLATE_AUTH_LDAP_USER_SEARCH: CN=Users,DC=example,DC=com WEBLATE_AUTH_LDAP_USER_SEARCH_FILTER: (sAMAccountName=%(user)s)
Vegeu també
GitHub¶
- WEBLATE_SOCIAL_AUTH_GITHUB_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ORG_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ORG_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ORG_NAME¶
- WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_TEAM_ID¶
Habilita Autenticació GitHub.
GitHub Enterprise Edition¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_KEY¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_URL¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_API_URL¶
- WEBLATE_SOCIAL_AUTH_GITHUB_ENTERPRISE_SCOPE¶
Habilita GitHub EE authentication.
Bitbucket¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_SECRET¶
Habilita Autenticació Bitbucket.
Facebook¶
- WEBLATE_SOCIAL_AUTH_FACEBOOK_KEY¶
- WEBLATE_SOCIAL_AUTH_FACEBOOK_SECRET¶
Habilita Facebook OAuth 2.
Google¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_WHITELISTED_DOMAINS¶
- WEBLATE_SOCIAL_AUTH_GOOGLE_OAUTH2_WHITELISTED_EMAILS¶
Habilita Google OAuth 2.
GitLab¶
- WEBLATE_SOCIAL_AUTH_GITLAB_KEY¶
- WEBLATE_SOCIAL_AUTH_GITLAB_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITLAB_API_URL¶
Habilita GitLab OAuth 2.
Gitea¶
- WEBLATE_SOCIAL_AUTH_GITEA_API_URL¶
- WEBLATE_SOCIAL_AUTH_GITEA_KEY¶
- WEBLATE_SOCIAL_AUTH_GITEA_SECRET¶
Enables Gitea authentication.
ID d’entrada de Microsoft¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_SECRET¶
Habilita l’autenticació de Microsoft Entra ID, vegeu ID d’entrada de Microsoft.
Microsoft Entra ID amb suport per a llogaters¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_SECRET¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_TENANT_ID¶
Habilita l’autenticació d’ID de Microsoft Entra amb suport de llogater, vegeu ID d’entrada de Microsoft.
Keycloak¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_KEY¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_SECRET¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_PUBLIC_KEY¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_ALGORITHM¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_AUTHORIZATION_URL¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_ACCESS_TOKEN_URL¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_TITLE¶
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_IMAGE¶
Enables Keycloak authentication.
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_ID_KEY¶
Afegit a la versió 5.17.
Configures which claim is used as the unique user identifier from Keycloak. Defaults to the stable subject claim,
sub. Explicit overrides remain supported, but e-mail addresses and usernames can be reassigned and are unsafe account identifiers. See Keycloak authentication for migration and historical-key backfill requirements when upgrading from the earlieremaildefault.Suggeriment
Quan Keycloak està configurat per abstraure l’IDP de tercers, haureu de configurar
WEBLATE_CSP_FORM_SRCper al domini d’IDP de tercers.Exemple quan Keycloak passa l’autenticació a Microsoft.¶environment: WEBLATE_CSP_FORM_SRC: login.microsoftonline.com
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_ALLOW_UNVERIFIED_LEGACY_UID_MIGRATION¶
Afegit a la versió 2026.11.2.
Allows migration of historical Keycloak associations without saved subject evidence. Defaults to enabled only when
WEBLATE_SOCIAL_AUTH_KEYCLOAK_ID_KEYis unset; an explicit identifier, includingsub, defaults to disabled. Set to1or0to override this default. When disabled, matching saved subjects are required; associations without this evidence then require account recovery or verified administrative repair. Until migration, enabled fallback retains the risk of historical e-mail address or username reassignment. See Keycloak authentication for upgrade guidance.
Proveïdors de Linux¶
Podeu habilitar l’autenticació mitjançant serveis d’autenticació de proveïdors de Linux establint les variables següents a qualsevol valor.
- WEBLATE_SOCIAL_AUTH_FEDORA¶
- WEBLATE_SOCIAL_AUTH_OPENSUSE¶
- WEBLATE_SOCIAL_AUTH_OPENINFRA¶
- WEBLATE_SOCIAL_AUTH_UBUNTU¶
Slack¶
- WEBLATE_SOCIAL_AUTH_SLACK_KEY¶
OpenID Connect identity provider¶
Afegit a la versió 2026.11.
- WEBLATE_OIDC_PROVIDER_ENABLED¶
Enable the optional OpenID Connect identity provider. Defaults to
False. The image must include theoidcinstallation extra; see Configuration beyond environment variables. Enabling the provider installs its Django applications and migrations.
- WEBLATE_OIDC_PROVIDER_RSA_PRIVATE_KEY_FILE¶
Required when
WEBLATE_OIDC_PROVIDER_ENABLEDis enabled. Path to a mounted, unencrypted RSA private key used to sign ID tokens. Generate it as described in OpenID Connect identity provider. Weblate does not generate this key. To retain inactive keys during rotation, configureOAUTH2_PROVIDERinsettings-override.py.
OpenID Connect¶
Afegit a la versió 4.13-1.
- WEBLATE_SOCIAL_AUTH_OIDC_OIDC_ENDPOINT¶
- WEBLATE_SOCIAL_AUTH_OIDC_KEY¶
- WEBLATE_SOCIAL_AUTH_OIDC_SECRET¶
- WEBLATE_SOCIAL_AUTH_OIDC_USERNAME_KEY¶
- WEBLATE_SOCIAL_AUTH_OIDC_TITLE¶
- WEBLATE_SOCIAL_AUTH_OIDC_IMAGE¶
Configura la integració genèrica d’OpenID Connect.
Vegeu també
Weblate OpenID Connect¶
Afegit a la versió 2026.11.
- WEBLATE_SOCIAL_AUTH_WEBLATE_KEY¶
- WEBLATE_SOCIAL_AUTH_WEBLATE_SECRET¶
Enable authentication through Hosted Weblate or another Weblate installation (see Weblate OpenID Connect) using the client ID and client secret registered with its OpenID Connect identity provider. Register the exact HTTPS callback URL of this installation, for example
https://weblate.example.com/accounts/complete/weblate/.environment: WEBLATE_SOCIAL_AUTH_WEBLATE_KEY: your-client-id WEBLATE_SOCIAL_AUTH_WEBLATE_SECRET_FILE: /run/secrets/weblate-client-secret
- WEBLATE_SOCIAL_AUTH_WEBLATE_OIDC_ENDPOINT¶
Optional issuer URL. Defaults to
https://hosted.weblate.org/oidc. For another installation, use its base URL followed by/oidc, including any deployment prefix, for examplehttps://example.com/translations/oidc. Do not append/.well-known/openid-configuration.Changing the issuer requires an explicit migration of existing account associations: the same subject identifier on different servers can refer to different people.
- WEBLATE_SOCIAL_AUTH_WEBLATE_TITLE¶
- WEBLATE_SOCIAL_AUTH_WEBLATE_IMAGE¶
Optional sign-in label and icon overrides. By default, the label is Hosted Weblate for Hosted Weblate and Weblate for other installations; both use the Weblate icon.
Vegeu també
Fedora OpenID Connect¶
Afegit a la versió 5.15.
- WEBLATE_SOCIAL_AUTH_FEDORA_OIDC_KEY¶
SAML¶
Les claus SAML autosignades es generen automàticament a l’inici del primer contenidor. En cas que vulgueu utilitzar claus pròpies, col·loqueu el certificat i la clau privada a /app/data/ssl/saml.crt i /app/data/ssl/saml.key.
- WEBLATE_SAML_IDP_ENTITY_ID¶
- WEBLATE_SAML_IDP_URL¶
- WEBLATE_SAML_IDP_X509CERT¶
- WEBLATE_SAML_IDP_IMAGE¶
- WEBLATE_SAML_IDP_TITLE¶
Configuració del proveïdor d’identitat SAML, vegeu Autenticació SAML.
- WEBLATE_SAML_SECURITY_CONFIG¶
Afegit a la versió 2026.6.
Configuració de seguretat SAML com a objecte JSON, passat a
SOCIAL_AUTH_SAML_SECURITY_CONFIG. Per exemple, per desactivar elrequestedAuthnContext(necessari per a alguns proveïdors d’identitat, com ara Microsoft Entra ID amb autenticació multifactor):environment: WEBLATE_SAML_SECURITY_CONFIG: '{"requestedAuthnContext": false}'
Vegeu també
- WEBLATE_SAML_ID_ATTR_FULL_NAME¶
- WEBLATE_SAML_ID_ATTR_FIRST_NAME¶
- WEBLATE_SAML_ID_ATTR_LAST_NAME¶
- WEBLATE_SAML_ID_ATTR_USERNAME¶
- WEBLATE_SAML_ID_ATTR_EMAIL¶
- WEBLATE_SAML_ID_ATTR_USER_PERMANENT_ID¶
Afegit a la versió 4.18.
Mapeig d’atributs SAML.
Altres configuracions d’autenticació¶
- WEBLATE_NO_EMAIL_AUTH¶
Desactiva l’autenticació de correu electrònic quan s’estableix en qualsevol valor. Vegeu S’està desactivant l’autenticació de contrasenya.
Configuració de la base de dades PostgreSQL¶
La base de dades la crea docker-compose.yml, de manera que aquests paràmetres afecten tant els contenidors Weblate com PostgreSQL.
Vegeu també
- POSTGRES_PASSWORD¶
Contrasenya PostgreSQL.
Vegeu també
- POSTGRES_USER¶
Nom d’usuari PostgreSQL.
- POSTGRES_DB¶
Nom de la base de dades PostgreSQL.
- POSTGRES_HOST¶
Nom d’amfitrió del servidor PostgreSQL o adreça IP. Per defecte és
base de dades.
- POSTGRES_PORT¶
Port del servidor PostgreSQL. El valor predeterminat és cap (utilitza el valor per defecte).
- POSTGRES_SSL_MODE¶
Configureu com PostgreSQL gestiona SSL en connexió amb el servidor; per a possibles opcions, consulteu Descripcions del mode SSL.
- POSTGRES_ALTER_ROLE¶
Configura el nom del rol PostgreSQL per modificar-lo durant la migració de la base de dades, vegeu Configuració de Weblate per utilitzar PostgreSQL.
El valor per defecte és
POSTGRES_USER.
- POSTGRES_CONN_MAX_AGE¶
Afegit a la versió 4.8.1.
La vida útil d’una connexió de base de dades, com a nombre enter de segons. Utilitzeu 0 per tancar les connexions de base de dades al final de cada sol·licitud.
Canviat a la versió 5.1: El comportament predeterminat és tenir connexions de base de dades persistents il·limitades.
Habilitar la persistència de la connexió normalment provocarà una connexió més oberta a la base de dades. Ajusteu la configuració de la vostra base de dades abans d’activar-la.
Exemple de configuració:
environment: POSTGRES_CONN_MAX_AGE: 3600
Vegeu també
- POSTGRES_DISABLE_SERVER_SIDE_CURSORS¶
Afegit a la versió 4.9.1.
Desactiveu els cursors del costat del servidor a la base de dades. Això és necessari en algunes configuracions pgbouncer.
Exemple de configuració:
environment: POSTGRES_DISABLE_SERVER_SIDE_CURSORS: 1
- WEBLATE_DATABASES¶
Afegit a la versió 5.1.
S’estableix en false per desactivar la configuració basada en l’entorn de la connexió de la base de dades. Utilitzeu Anulació de la configuració del volum de dades per configurar la connexió de la base de dades manualment.
Configuració de còpia de seguretat de la base de dades¶
Vegeu també
- WEBLATE_DATABASE_BACKUP¶
Configura l’abocament diari de la base de dades mitjançant
DATABASE_BACKUP. El valor predeterminat ésplain.
Configuració del servidor de magatzem de dades¶
El contenidor Weblate requereix l’ús de Valkey o Redis i heu de proporcionar uns paràmetres de connexió quan executeu Weblate a Docker.
The datastore and any proxy must support RESP3.
Vegeu també
Configure cache for version requirements and troubleshooting
unknown command HELLO errors.
- REDIS_HOST¶
El nom d’amfitrió del servidor de magatzem de dades o l’adreça IP. El valor per defecte és
cache.
- REDIS_PORT¶
El port del servidor del magatzem de dades. El valor predeterminat és
6379.
- REDIS_DB¶
The datastore database number, defaults to
1.
- REDIS_USER¶
Afegit a la versió 5.13: The datastore database user, not used by default.
- REDIS_PASSWORD¶
The datastore server password, not used by default.
Vegeu també
- REDIS_TLS¶
Habilita l’ús de SSL per a la connexió del magatzem de dades.
- REDIS_VERIFY_SSL¶
Es pot utilitzar per desactivar la verificació del certificat SSL per a la connexió del magatzem de dades.
Configuració del servidor de correu electrònic¶
Perquè el correu electrònic de sortida funcioni, cal que proporcioneu un servidor de correu.
Exemple de configuració de TLS:
environment:
WEBLATE_EMAIL_HOST: smtp.example.com
WEBLATE_EMAIL_HOST_USER: user
WEBLATE_EMAIL_HOST_PASSWORD: pass
Exemple de configuració SSL:
environment:
WEBLATE_EMAIL_HOST: smtp.example.com
WEBLATE_EMAIL_PORT: 465
WEBLATE_EMAIL_HOST_USER: user
WEBLATE_EMAIL_HOST_PASSWORD: pass
WEBLATE_EMAIL_USE_TLS: 0
WEBLATE_EMAIL_USE_SSL: 1
Vegeu també
- WEBLATE_EMAIL_HOST¶
Nom d’amfitrió del servidor de correu o adreça IP.
- WEBLATE_EMAIL_PORT¶
Port del servidor de correu, el valor predeterminat és 25.
Vegeu també
- WEBLATE_EMAIL_HOST_USER¶
E-mail authentication user.
Vegeu també
- WEBLATE_EMAIL_HOST_PASSWORD¶
E-mail authentication password.
Vegeu també
- WEBLATE_EMAIL_USE_SSL¶
Si s’ha d’utilitzar una connexió TLS (segura) implícita quan es parla amb el servidor SMTP. A la majoria de la documentació de correu electrònic, aquest tipus de connexió TLS s’anomena SSL. Generalment s’utilitza al port 465. Si teniu problemes, consulteu la configuració explícita de TLS
WEBLATE_EMAIL_USE_TLS.Canviat a la versió 4.11: El suport SSL/TLS s’habilita automàticament en funció del
WEBLATE_EMAIL_PORT.Vegeu també
- WEBLATE_EMAIL_USE_TLS¶
Si s’ha d’utilitzar una connexió TLS (segura) quan es parla amb el servidor SMTP. S’utilitza per a connexions TLS explícites, generalment al port 587 o 25. Si esteu experimentant connexions que es pengen, consulteu la configuració implícita de TLS
WEBLATE_EMAIL_USE_SSL.Canviat a la versió 4.11: El suport SSL/TLS s’habilita automàticament en funció del
WEBLATE_EMAIL_PORT.Vegeu també
- WEBLATE_EMAIL_BACKEND¶
Configura el back-end de Django per utilitzar-lo per enviar correus electrònics.
Set to
django_ses.SESBackendto use AWS SES.
- WEBLATE_AWS_SES_REGION_NAME¶
AWS region for SES (e.g.
us-east-1). SetsAWS_SES_REGION_NAMEand derivesWEBLATE_AWS_SES_REGION_ENDPOINTautomatically unless that variable is set explicitly. If not set, the region must be available through the standard boto3 credential chain (e.g.AWS_DEFAULT_REGIONor an AWS profile).
- WEBLATE_AWS_SES_REGION_ENDPOINT¶
SES endpoint hostname. When set, it is passed to django-ses directly regardless of
WEBLATE_AWS_SES_REGION_NAME. When not set butWEBLATE_AWS_SES_REGION_NAMEis provided, defaults toemail.<region>.amazonaws.com. Override when using a VPC or custom endpoint.
- WEBLATE_USE_SES_V2¶
Set to
trueto use the SES v2 API (SendEmail) instead of the legacySendRawEmailcall. Boolean setting (use"true"or"false").
- WEBLATE_AUTO_UPDATE¶
Configura si i com ha d’actualitzar Weblate els repositoris.
The default,
"false", fetches remote changes daily without merging them into the working copy; it does not disable daily updates. Set to"true"to also merge remote changes into the working copy.Vegeu també
AUTO_UPDATEfor details on how updates are scheduled throughout the day.Nota
Aquesta és una configuració booleana (utilitza
"true"o"false").
Site integration¶
- WEBLATE_GET_HELP_URL¶
Configura
GET_HELP_URL.
- WEBLATE_STATUS_URL¶
Configura
STATUS_URL.
- WEBLATE_PRIVACY_URL¶
Configura
PRIVACY_URL.
- WEBLATE_PASSWORD_RESET_URL¶
Configures
PASSWORD_RESET_URL.
Recollida d’informes d’errors i seguiment del rendiment¶
Es recomana recopilar els errors de la instal·lació de manera sistemàtica, vegeu Recollida d’informes d’errors i seguiment del rendiment.
Per habilitar la compatibilitat amb Rollbar, configureu el següent:
- ROLLBAR_KEY¶
El vostre testimoni d’accés al servidor de publicacions de Rollbar.
- ROLLBAR_ENVIRONMENT¶
El vostre entorn Rollbar, per defecte és
producció.
Per habilitar el suport per a Sentry, configureu el següent:
- SENTRY_DSN¶
El vostre DSN de Sentry, vegeu
SENTRY_DSN.
- SENTRY_ENVIRONMENT¶
El vostre entorn Sentry (opcional), el valor predeterminat és
WEBLATE_SITE_DOMAIN.
- SENTRY_MONITOR_BEAT_TASKS¶
Si s’han de controlar les tasques de Celery Beat amb Sentry, el valor predeterminat és
True.
- SENTRY_TRACES_SAMPLE_RATE¶
Configura
SENTRY_TRACES_SAMPLE_RATE.Exemple:
environment: SENTRY_TRACES_SAMPLE_RATE: 0.5
- SENTRY_PROFILES_SAMPLE_RATE¶
Configura
SENTRY_PROFILES_SAMPLE_RATE.Exemple:
environment: SENTRY_PROFILES_SAMPLE_RATE: 0.5
- SENTRY_SEND_PII¶
Configura
SENTRY_SEND_PII.
Per activar la compatibilitat amb els informes d’errors de Google Cloud, configureu el següent:
- GOOGLE_CLOUD_ERROR_REPORTING_ENABLED¶
Activa
GOOGLE_CLOUD_ERROR_REPORTING, el valor predeterminat ésFalse.
- GOOGLE_CLOUD_ERROR_REPORTING_PROJECT¶
Projecte de Google Cloud per informar d’errors. Si s’omet, el client de Google utilitza les credencials predeterminades de l’aplicació per detectar el projecte.
- GOOGLE_CLOUD_ERROR_REPORTING_SERVICE¶
Nom del servei que s’ha d’utilitzar a l’Informe d’errors de Google Cloud, el valor predeterminat és
weblate.
Per habilitar el suport per al seguiment d’OpenTelemetry, configureu el següent:
- OPENTELEMETRY_ENABLED¶
Activa
OPENTELEMETRY_ENABLED, el valor predeterminat ésFalse.
- OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT¶
Configures
OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT.Exemple:
environment: OPENTELEMETRY_ENABLED: true OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT: https://collector.example.com/v1/traces OPENTELEMETRY_TRACES_SAMPLE_RATE: 0.1
- OPENTELEMETRY_EXPORTER_OTLP_HEADERS¶
Configura
OPENTELEMETRY_EXPORTER_OTLP_HEADERScom a mapeignom:valorseparat per comes.
- OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES¶
Configura
OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTEScom a mapeignom:valorseparat per comes.
- OPENTELEMETRY_SERVICE_NAME¶
Configures
OPENTELEMETRY_SERVICE_NAME.
- OPENTELEMETRY_TRACES_SAMPLE_RATE¶
Configures
OPENTELEMETRY_TRACES_SAMPLE_RATE.
Localization CDN¶
- WEBLATE_LOCALIZE_CDN_URL¶
- WEBLATE_LOCALIZE_CDN_PATH¶
Afegit a la versió 4.2.1.
Configuració dels complements CDN, inclosos CDN de localització de JavaScript i CDN dels fitxers de traducció.
El
WEBLATE_LOCALIZE_CDN_PATHés el camí dins del contenidor. S’ha d’emmagatzemar al volum persistent i no a l’emmagatzematge transitori.Una de les possibilitats és emmagatzemar-ho dins del directori de dades de Weblate:
environment: WEBLATE_LOCALIZE_CDN_URL: https://cdn.example.com/ WEBLATE_LOCALIZE_CDN_PATH: /app/data/l10n-cdn
Nota
Vostè és responsable de configurar el servei dels fitxers generats per Weblate, només emmagatzema els fitxers a la ubicació configurada. Vegeu Localization CDN per obtenir una guia de servei segur.
Changing enabled apps, checks, formats, add-ons, translation services, or autofixes¶
The built-in configuration of enabled checks, file formats, add-ons, translation services, or autofixes can be adjusted by the following variables:
- WEBLATE_ADD_APPS¶
- WEBLATE_REMOVE_APPS¶
- WEBLATE_ADD_CHECK¶
- WEBLATE_REMOVE_CHECK¶
- WEBLATE_ADD_AUTOFIX¶
- WEBLATE_REMOVE_AUTOFIX¶
- WEBLATE_ADD_FORMATS¶
- WEBLATE_REMOVE_FORMATS¶
- WEBLATE_ADD_ADDONS¶
- WEBLATE_REMOVE_ADDONS¶
- WEBLATE_ADD_MACHINERY¶
Afegit a la versió 5.6.1.
- WEBLATE_REMOVE_MACHINERY¶
Afegit a la versió 5.6.1.
Exemple:
environment:
WEBLATE_REMOVE_AUTOFIX: weblate.trans.autofixes.whitespace.SameBookendingWhitespace
WEBLATE_REMOVE_FORMATS: weblate.formats.ttkit.PoFormat
WEBLATE_ADD_ADDONS: customize.addons.MyAddon,customize.addons.OtherAddon
Container settings¶
- WEBLATE_WORKERS¶
Afegit a la versió 4.6.1.
Nombre base de processos de treball que s’executen al contenidor. Quan no s’estableix, es determina automàticament a l’inici del contenidor en funció del nombre de nuclis de CPU disponibles.
It is used to determine
CELERY_MAIN_OPTIONS,CELERY_COMBINED_OPTIONS,CELERY_NOTIFY_OPTIONS,CELERY_MEMORY_OPTIONS,CELERY_TRANSLATE_OPTIONS,CELERY_BACKUP_OPTIONS,WEB_WORKERS, andWEB_BLOCKING_THREADS. You can use these settings to fine-tune.
- CELERY_WORKER_MODE¶
Afegit a la versió 2026.9.1.
Selects how Celery workers are run in the container. Supported modes are:
combinedRuns one prefork worker for all queues. This is the default and reduces memory usage by sharing the application startup memory. Its concurrency defaults to three times
WEBLATE_WORKERS, and its prefetch multiplier defaults to one.splitRuns a separate prefork worker for each queue. This matches the behavior of container versions before 2026.9.1 and allows each queue to be tuned independently.
singleRuns all queues in one process using the solo pool. This minimizes memory usage, but noticeably reduces task throughput.
Explicit
WEBLATE_SERVICEselection takes precedence over this setting in horizontally scaled deployments.
- CELERY_COMBINED_OPTIONS¶
Afegit a la versió 2026.9.1.
Configures the worker used by
CELERY_WORKER_MODE=combined. By default, its concurrency is three timesWEBLATE_WORKERS. The worker uses a prefetch multiplier of one unless overridden here.environment: CELERY_COMBINED_OPTIONS: --concurrency 12 --prefetch-multiplier 1
Vegeu també
- CELERY_MAIN_OPTIONS¶
- CELERY_NOTIFY_OPTIONS¶
- CELERY_MEMORY_OPTIONS¶
- CELERY_TRANSLATE_OPTIONS¶
- CELERY_BACKUP_OPTIONS¶
These variables allow you to adjust Celery worker options in
CELERY_WORKER_MODE=split. It can be useful to adjust concurrency (--concurrency 16), prefetching (--prefetch-multiplier 4), or use different pool implementation (--pool=gevent). Command-line options take precedence over corresponding Celery settings, allowing each worker category to use a different prefetch multiplier. When any of these variables is set incombinedorsinglemode, the container logs a startup warning that it is ignored.Per defecte, el nombre de treballadors concurrents es basa en
WEBLATE_WORKERS.Exemple:
environment: CELERY_MAIN_OPTIONS: --concurrency 16 --prefetch-multiplier 1
Vegeu també
- CELERY_BEAT_OPTIONS¶
Configures the Celery beat scheduler in all worker modes.
- CELERY_SINGLE_OPTIONS¶
Configures the worker used by
CELERY_WORKER_MODE=single.
- CELERY_SINGLE_PROCESS¶
Afegit a la versió 5.7.1.
Obsolet des de la versió 2026.9.1.
Compatibility alias for
CELERY_WORKER_MODE=single. When set to1withoutCELERY_WORKER_MODE, the container starts insinglemode and logs a warning asking you to update the setting. If both variables are set,CELERY_WORKER_MODEtakes precedence.Vegeu també
- WEBLATE_ASGI¶
Afegit a la versió 2026.8.
Set to
1to run the web application using ASGI instead of WSGI. This is an opt-in setting intended for testing the transition to ASGI. WSGI remains the default for now, but a future release will run ASGI only and remove this setting.environment: WEBLATE_ASGI: 1
Vegeu també
- WEB_WORKERS¶
Configure how many web application workers should be executed.
El valor predeterminat és la meitat de
WEBLATE_WORKERS, però sempre és com a mínim 2.Exemple:
environment: WEB_WORKERS: 4
Canviat a la versió 5.13:
WEB_WORKERSconfigures how many worker processes will be used by granian.
- WEB_BLOCKING_THREADS¶
Configure how many blocking WSGI threads each granian worker can use. It defaults to twice
WEBLATE_WORKERSand is ignored whenWEBLATE_ASGIis enabled.The maximum number of simultaneous WSGI requests is approximately
WEB_WORKERSmultiplied byWEB_BLOCKING_THREADS. Each thread can hold its own database connection, so keep the resulting total within the database connection limit.Exemple:
environment: WEB_WORKERS: 2 WEB_BLOCKING_THREADS: 8
- WEBLATE_SERVICE¶
Defineix quins serveis s’han d’executar dins del contenidor. Utilitzeu-ho per a Escala horitzontal.
Following services are defined:
celery-beatProgramador de tasques d’api, només s’ha d’executar una instància. Aquest contenidor també és responsable de les migracions de l’estructura de la base de dades i s’hauria d’iniciar abans d’altres.
celery-backupTreballador d’api per a còpies de seguretat, només s’hauria d’executar una instància.
celery-combinedCombined Celery worker for all task queues.
celery-celeryTreballador de l’api genèric.
celery-memoryTranslation memory Celery worker.
celery-notifyNotifications Celery worker.
celery-singleSingle-process Celery worker for all task queues.
celery-translateAutomatic translation Celery worker.
webServidor web.
Vegeu també
- WEBLATE_ANUBIS_URL¶
Afegit a la versió 5.11.4.
URL del servidor Anubis per gestionar l’autenticació de la subsol·licitud. Això pot ser útil per filtrar les sol·licituds HTTP entrants mitjançant la prova de treball per aturar els rastrejadors d’IA. Heu de configurar Anubis per a l’autenticació de subsol·licituds perquè funcioni.
Use an
http://orhttps://URL with a valid hostname or IPv4 address. The URL can include a port and a simple slash-separated path using ASCII letters, digits,_, and-. Credentials, queries, fragments, and IPv6 addresses are not supported.Vegeu també
Volums de contenidors Docker¶
Hi ha dos volums (data i cache) exportats pel contenidor Weblate.
Nota
Els altres contenidors de serveis (com PostgreSQL o Valkey) també tenen els seus volums de dades i són necessaris per mantenir la persistència del Weblate.
El contenidor PostgreSQL emmagatzema la base de dades al volum /var/lib/postgresql i Valkey al volum /data. El contenidor Valkey no desa les dades de manera predeterminada i necessita una configuració addicional per habilitar la persistència.
Baseu la vostra configuració en exemples proporcionats per Weblate o consulteu la seva documentació per obtenir més informació.
El volum data es munta com a /app/data i s’utilitza per emmagatzemar dades persistents de Weblate, com ara repositoris clonats o per personalitzar la instal·lació de Weblate. DATA_DIR descriu amb més detall el que s’emmagatzema aquí.
El volum data també és un lloc per emmagatzemar la personalització de Weblate com ara Anulació de la configuració del volum de dades, Substitució del logotip i altres fitxers estàtics o Customizing code.
La col·locació del volum Docker al sistema amfitrió depèn de la configuració de Docker, però normalment s’emmagatzema a /var/lib/docker/volumes/weblate-docker_weblate-data/_data/ (el camí consisteix en el nom del directori, contenidor i volums de docker-compose).
El volum cache es munta com a /app/cache i s’utilitza per emmagatzemar fitxers estàtics i CACHE_DIR. El seu contingut es recrea a l’inici del contenidor i el volum es pot muntar mitjançant un sistema de fitxers efímer com ara tmpfs, però el muntatge ha de permetre l’execució perquè Weblate emmagatzema els fitxers d’ajuda generats allà.
Quan munteu /app/cache explícitament com a tmpfs a Docker Compose, activeu l’execució:
tmpfs:
- /app/cache:exec
Quan també configureu les opcions de propietat, manteniu l’opció exec:
tmpfs:
- /app/cache:exec,uid=1000,gid=1000
Quan es creen els volums manualment, els directoris haurien de ser propietat de l’UID 1000, ja que l’usuari s’utilitza dins del contenidor.
El contenidor Weblate també es pot executar amb un sistema de fitxers arrel de només lectura. En aquest cas, s’han de muntar dos volums tmpfs addicionals: /tmp i /run.
Vegeu també
Read-only root filesystem¶
Afegit a la versió 4.18.
Quan s’executa el contenidor amb un sistema de fitxers arrel només de lectura, calen dos volums tmpfs addicionals: /tmp i /run.
Configuration beyond environment variables¶
Docker environment variables are intended to expose most configuration settings of relevance for Weblate installations.
Si trobeu una configuració que no s’exposa com a variable d’entorn, i creieu que ho hauria de ser, no dubteu a demanar que s’exposi en una versió futura de Weblate.
Si necessiteu modificar una configuració que no s’exposa com a variable d’entorn de Docker, encara podeu fer-ho, ja sigui des del volum de dades o bé ampliant la imatge de Docker.
Vegeu també
Anulació de la configuració del volum de dades¶
Podeu crear un fitxer a /app/data/settings-override.py, és a dir, a l’arrel del volum de dades, per ampliar o anul·lar la configuració definida mitjançant variables d’entorn.
Anulant la configuració ampliant la imatge de Docker¶
Per anul·lar la configuració al nivell d’imatge de Docker en lloc del volum de dades:
Afegiu un mòdul al vostre paquet que importi tota la configuració de
weblate.settings_docker.Per exemple, dins de l’estructura del paquet d’exemple definida a Creació d’un mòdul Python, podeu crear un fitxer a
weblate_customization/weblate_customization/settings.pyamb el codi inicial següent:from weblate.settings_docker import *
Creeu un
Dockerfilepersonalitzat que hereta de la imatge oficial de Weblate Docker i, a continuació, instal·la el vostre paquet i dirigeix la variable d’entornDJANGO_SETTINGS_MODULEal vostre mòdul de configuració:FROM weblate/weblate USER root COPY weblate_customization /usr/src/weblate_customization RUN source /app/venv/bin/activate && uv pip install --no-cache-dir /usr/src/weblate_customization ENV DJANGO_SETTINGS_MODULE=weblate_customization.settings USER 1000
En lloc d’utilitzar la imatge oficial de Weblate Docker, creeu una imatge personalitzada a partir d’aquest fitxer
Dockerfile.No hi ha cap manera neta de fer-ho amb
docker-compose.override.yml. Podeu afegirbuild: .al nodeweblated’aquest fitxer, però aleshores la vostra imatge personalitzada s’etiquetarà com aweblate/weblateal vostre sistema, cosa que podria ser problemàtica.Per tant, en comptes d’utilitzar el
docker-compose.ymldirectament des del repositori oficial, sense modificar-lo, i estendre’l mitjançantdocker-compose.override.yml, potser voldreu fer una còpia del fitxer oficialdocker-compose.ymlper substituir el fitxer webdocker-compose.ymlper reemplaçar i editar la vostra imatge web:construeix: ..Vegeu la Referència de compilació de fitxers de redacció per obtenir més informació sobre la creació d’imatges des de la font quan utilitzeu
docker-compose.Amplieu el vostre mòdul de configuració personalitzada per definir o redefinir la configuració.
Podeu definir paràmetres abans o després de la declaració d’importació anterior per determinar quins paràmetres tenen prioritat. Els paràmetres definits abans de la declaració d’importació es poden substituir per les variables d’entorn i les substitucions de configuració definides al volum de dades. La configuració definida després de la instrucció d’import no es pot substituir.
També pots anar més enllà. Per exemple, podeu reproduir algunes de les coses que
weblate.docker_settingsfa, com ara exposar la configuració com a variables d’entorn, o permetre substituir la configuració dels fitxers Python al volum de dades.
Substitució del logotip i altres fitxers estàtics¶
Els fitxers estàtics que vénen amb Weblate es poden substituir col·locant-los a /app/data/python/customize/static (vegeu Volums de contenidors Docker). Per exemple, crear /app/data/python/customize/static/favicon.ico substituirà el favicon.
Suggeriment
Els fitxers es copien a la ubicació corresponent a l’inici del contenidor, de manera que cal reiniciar Weblate després de canviar el contingut del volum.
This approach can be also used to override Weblate templates. For example, custom Legal module documents and styles can be provided as described in Customizing legal documents and styles.
Alternativament, també podeu incloure el vostre mòdul (vegeu Customizing Weblate) i afegir-lo com a volum independent al contenidor Docker, per exemple:
weblate:
volumes:
- weblate-data:/app/data
- ./weblate_customization/weblate_customization:/app/data/python/weblate_customization
environment:
WEBLATE_ADD_APPS: weblate_customization
Customizing code¶
Nota
L’API interna de Weblate pot variar significativament entre les versions i no està pensada per ser estable. Reviseu el vostre codi personalitzat que interactua amb els components interns de Weblate a cada actualització.
Podeu col·locar codi Python addicional a /app/data/python/customize (vegeu Volums de contenidors Docker). Ja està instal·lat com a aplicació Django dins de Weblate (això s’utilitza per personalitzar plantilles i fitxers estàtics tal com es descriu anteriorment).
Això es pot utilitzar per col·locar qualsevol codi (per exemple Redacció de xecs propis) o per afegir tasques de manteniment personalitzades al programador de tasques Celery.
/app/data/python/customize/tasks.py.¶"""Custom scheduled task."""
from __future__ import annotations
# ruff: ignore[suspicious-subprocess-import]
import subprocess
from typing import TYPE_CHECKING
from celery.schedules import crontab
from weblate.utils.celery import app
if TYPE_CHECKING:
from celery import Celery
@app.task
def custom_task() -> None:
"""Execute custom task code."""
# ruff: ignore[start-process-with-partial-path]
subprocess.run(["sleep", "1"], check=True)
@app.on_after_finalize.connect
def setup_periodic_tasks(sender: Celery, **kwargs: object) -> None:
"""Configure when periodic task is triggered."""
sender.add_periodic_task(
crontab(hour=1, minute=0), custom_task.s(), name="custom-task"
)
Integrating third-party containers¶
La configuració de Weblate Docker es pot ampliar amb contenidors addicionals per oferir serveis complementaris com ara traducció automàtica, correcció ortogràfica o altres eines que milloren el flux de treball de traducció. Aquests serveis es poden integrar a la configuració de Docker Compose i treballar juntament amb Weblate.
When adding third-party containers, consider the following:
Connectivitat de xarxa: assegureu-vos que els contenidors es puguin comunicar entre ells col·locant-los a la mateixa xarxa Docker
Persistència de dades: utilitzeu volums per als serveis que necessiten persistir dades
Seguretat: configureu els controls d’accés adequats i eviteu exposar ports innecessaris
LibreTranslate Docker container integration¶
LibreTranslate és un servei de traducció automàtica gratuït i de codi obert que es pot allotjar per si mateix. Integrar-lo amb Weblate proporciona capacitats de traducció automàtica fora de línia sense dependre de serveis externs.
Podeu incorporar el servei LibreTranslate al vostre desplegament de Weblate inclòs-lo en un fitxer docker-compose.override.yml. Com que s’executa a la xarxa Docker, només és accessible a Weblate i no està exposat a Internet pública.
Configuració bàsica mitjançant docker-compose.override.yml:
services:
libretranslate:
image: libretranslate/libretranslate:latest
command: --disable-web-ui
restart: unless-stopped
environment:
LT_UPDATE_MODELS: true
volumes:
- libretranslate_models:/home/libretranslate/.local:rw
healthcheck:
test: ['CMD-SHELL', './venv/bin/python scripts/healthcheck.py']
interval: 10s
timeout: 4s
retries: 4
start_period: 5s
volumes:
libretranslate_models:
Per a la traducció accelerada per GPU (si teniu disponible la GPU NVIDIA):
services:
libretranslate:
image: libretranslate/libretranslate:latest-cuda
command: --disable-web-ui
restart: unless-stopped
environment:
LT_UPDATE_MODELS: true
PUID: root
volumes:
- libretranslate_models:/home/libretranslate/.local:rw
healthcheck:
test: ['CMD-SHELL', './venv/bin/python scripts/healthcheck.py']
interval: 10s
timeout: 4s
retries: 4
start_period: 5s
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 1
capabilities: [gpu]
volumes:
libretranslate_models:
Després d’iniciar els serveis amb docker compose down && docker compose up -d, configureu LibreTranslate a Weblate:
Access the Weblate admin interface
Navigate to Manage → Translation services
Afegiu un nou servei LibreTranslate amb:
- Servei:
LibreTranslate
- URL de l’API:
http://libretranslate:5000- Clau de l’API:
Deixar buit
LibreTranslate ara està configurat i disponible per a la traducció automàtica a Weblate.
Nota
El servei LibreTranslate s’executa sense la interfície d’usuari web (
--disable-web-ui) i només s’hi pot accedir mitjançant l’API dins de la xarxa Docker.Els models s’actualitzen automàticament quan s’inicia el contenidor. (
LT_UPDATE_MODELS: cert)Les dades es mantenen utilitzant els volums Docker per obtenir un rendiment i una seguretat de dades òptims.
Les comprovacions de salut asseguren que el motor Docker observa correctament l’estat del servei.
Per accelerar la GPU, utilitzeu la variant d’imatge CUDA i assegureu-vos que el vostre sistema tingui compatibilitat amb NVIDIA Docker. Aquest contenidor s’executa com a usuari amb privilegis per poder utilitzar la GPU.
No hi ha cap port extern exposat, la qual cosa fa que la configuració sigui segura per defecte.
Anubis Docker container integration¶
Anubis és una utilitat de tallafocs d’IA web per bloquejar els raspadors d’IA i altres tràfics pertorbadors al servidor. Normalment es necessita per a les instal·lacions de Weblate obertes públicament per evitar una càrrega excessiva causada pel raspat.
Anubis es pot implementar mitjançant Docker Compose:
anubis:
image: ghcr.io/techarohq/anubis:latest
environment:
BIND: ":8923"
DIFFICULTY: "4"
METRICS_BIND: ":9090"
SERVE_ROBOTS_TXT: "false"
OG_PASSTHROUGH: "false"
# The single space in TARGET enables subrequest authentication
TARGET: " "
# The redirect domain has to match WEBLATE_SITE_DOMAIN
REDIRECT_DOMAINS: weblate.example.com
# Generate a random private key using: openssl rand -hex 32
ED25519_PRIVATE_KEY_HEX: "..."
# Customize your Anubis policy
POLICY_FNAME: /data/botPolicies.yaml
healthcheck:
test: ["CMD", "anubis", "--healthcheck"]
interval: 5s
timeout: 30s
retries: 5
start_period: 500ms
volumes:
- anubis-data:/data
volumes:
anubis-data:
Nota
S’espera que el volum anubis-data de la configuració anterior contingui botPolicies.yaml amb una política de bot configurada segons les vostres necessitats.
Com a mínim, heu d’ajustar els codis d’estat tal com es descriu a https://anubis.techaro.lol/docs/admin/configuration/subrequest-auth.
També es recomana configurar el backend d’emmagatzematge persistent tal com es descriu a https://anubis.techaro.lol/docs/admin/policies/#storage-backends.
Restrict Anubis’s REDIRECT_DOMAINS to your intended public hostnames, matching
WEBLATE_SITE_DOMAIN as shown above.
Challenge redirects and their return destinations use WEBLATE_SITE_DOMAIN,
including when a request arrives through an alias. Set WEBLATE_ENABLE_HTTPS
to 1 when a reverse proxy terminates TLS so these redirects use the public
HTTPS origin. Built-in TLS also selects HTTPS automatically. Include any public
nonstandard port in WEBLATE_SITE_DOMAIN.
A continuació, podeu activar l’ús d’Anubis a Weblate mitjançant:
environment:
WEBLATE_ANUBIS_URL: http://anubis:8923
Vegeu també
Application-aware proof of work¶
Afegit a la versió 2026.11.
This integration is a technology preview. See Anonymous bot protection for its stability and maintenance policy.
- WEBLATE_BOT_PROTECTION_ENABLED¶
- WEBLATE_BOT_PROTECTION_DIFFICULTY¶
- WEBLATE_BOT_PROTECTION_CHALLENGE_AGE¶
- WEBLATE_BOT_PROTECTION_COOKIE_AGE¶
- WEBLATE_BOT_PROTECTION_CACHE_ALIAS¶
- WEBLATE_BOT_PROTECTION_EXEMPT_PATHS¶
- WEBLATE_BOT_PROTECTION_EXEMPT_AGENTS¶
- WEBLATE_BOT_PROTECTION_CRAWLER_FILE¶
- WEBLATE_BOT_PROTECTION_CRAWLER_RULES¶
- WEBLATE_BOT_PROTECTION_UNWANTED_AGENTS¶
- WEBLATE_BOT_PROTECTION_UNWANTED_ACTION¶
Enable Anonymous bot protection with WEBLATE_BOT_PROTECTION_ENABLED set to
1. The Django gate works without an Anubis container. During migration,
remove WEBLATE_ANUBIS_URL from the container environment and recreate the
container to remove the NGINX Anubis subrequest gate. Keeping both enabled can
produce two challenges; application authentication cannot bypass an upstream
Anubis challenge. Existing Anubis configuration and cookies are not modified or
trusted by the application gate.
Every BOT_PROTECTION_* setting has a matching WEBLATE_BOT_PROTECTION_*
environment variable: DIFFICULTY (4), CHALLENGE_AGE (300), COOKIE_AGE
(3600), CACHE_ALIAS (default), EXEMPT_PATHS (empty list),
EXEMPT_AGENTS (empty list), CRAWLER_FILE (empty), CRAWLER_RULES (empty
JSON object), UNWANTED_AGENTS (empty list), and UNWANTED_ACTION (challenge). Lists use the standard comma-separated
Docker setting syntax. Configure a persistent writable crawler snapshot and run
weblate update_crawler_ranges daily from an external scheduler; application
workers do not perform refreshes. Restart application workers after updating
the snapshot; ranges are loaded only at startup and do not expire by age. Use
the existing shared cache for replay protection and best-effort verification
counters, shown in the management overview.
Set WEBLATE_BOT_PROTECTION_EXEMPT_AGENTS to comma-separated,
case-insensitive User-Agent regular expressions for monitoring exemptions.
For example, ^Weblate-Uptime/1\.0$ exempts a monitor using that exact agent.
Matching requests bypass bot protection for all methods and paths, including
unwanted-agent denial. This trusts a spoofable header and does not grant
application access; see BOT_PROTECTION_EXEMPT_AGENTS.
HTTPS, trusted proxy IP handling, same-origin challenge assets, and bypassing shared proxy caches for protected application routes are required. Deployments with CDN-hosted static files must provide these challenge assets at the same origin as Weblate.
Configuring PostgreSQL server¶
El contenidor PostgreSQL utilitza la configuració predeterminada de PostgreSQL i no utilitzarà de manera efectiva els nuclis o la memòria de la CPU. Es recomana personalitzar la configuració per millorar el rendiment.
La configuració es pot ajustar tal com es descriu a «Configuració de la base de dades» a https://hub.docker.com/_/postgres. La configuració que coincideixi amb el vostre entorn es pot generar mitjançant https://pgtune.leopard.in.ua/.
Container internals¶
El contenidor està utilitzant supervisor per iniciar serveis individuals. En cas de Escala horitzontal, només inicia un sol servei en un contenidor.
Per comprovar l’estat dels serveis, utilitzeu:
docker compose exec --user weblate weblate supervisorctl status
The Celery services depend on CELERY_WORKER_MODE. The default
combined mode runs celery-combined, while single mode runs
celery-single. You can stop all task processing in the default mode using:
docker compose exec --user weblate weblate supervisorctl stop celery-combined
The split mode runs an individual service for each Celery queue (see
Tasques de fons amb api for details). In this mode, you can stop processing some tasks by
stopping the appropriate worker:
docker compose exec --user weblate weblate supervisorctl stop celery-translate