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.

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

  2. Creeu un fitxer docker-compose.override.yml amb 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_PASSWORD no 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.yml per canviar-lo.

  3. Inicieu els contenidors de Weblate:

    docker compose up
    

Gaudeix del teu desplegament Weblate, és accessible al port 80 del contenidor weblate.

Escollint el registre d’imatges de Docker

Els contenidors de Weblate es publiquen als registres següents:

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

latest

Versió estable de Weblate, coincideix amb la darrera versió etiquetada

Actualitzacions en continu en un entorn de producció

<YEAR>

Weblate stable release

Actualitzacions en continu dins d’un any natural en un entorn de producció

<YEAR>.<MONTH>

Weblate stable release

Actualitzacions en continu dins d’un llançament mensual en un entorn de producció

<YEAR>.<MONTH>.<PATCH>.<BUILD>

Weblate stable release

Desplegament ben definit en un entorn de producció

edge

Versió estable de Weblate amb canvis de desenvolupament al contenidor Docker (per exemple, dependències actualitzades)

Actualitzacions en continu en un entorn de preparació

edge-<DATE>-<SHA>

Versió estable de Weblate amb canvis de desenvolupament al contenidor Docker (per exemple, dependències actualitzades)

Desplegament ben definit en un entorn de preparació

bleeding

Versió de desenvolupament Weblate de Git

Actualitzacions en continu per provar les properes funcions de Weblate

bleeding-<DATE>-<SHA>

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.

Exemple de configuració del servidor intermediari invers nginx per a un contenidor Docker.
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;
}
Entorn de contenidor Docker per a la terminació SSL externa.
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.pem que conté el certificat, inclosos els certificats CA necessaris

  • ssl/privkey.pem que 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 .crt files 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ó.

  1. Stop Weblate container:

    docker compose stop weblate cache
    
  2. Còpia de seguretat de la base de dades:

    docker compose exec database pg_dumpall --clean --if-exists --username weblate > backup.sql
    
  3. Atura el contenidor de la base de dades:

    docker compose stop database
    
  4. 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-docker en aquesta documentació.

  5. Ajusteu docker-compose.yml per utilitzar la nova versió de PostgreSQL.

  6. Inicieu el contenidor de la base de dades:

    docker compose up -d database
    
  7. 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.

  8. (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.

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

Configuració genèrica

WEBLATE_SECRET_KEY

Afegit a la versió 2026.12.

Configures Django’s SECRET_KEY. You can provide the key directly or use WEBLATE_SECRET_KEY_FILE to 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 through WEBLATE_SECRET_KEY_FILE causes 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é

Passing secrets

WEBLATE_DEBUG

Configura el mode de depuració de Django mitjançant DEBUG.

Exemple:

environment:
  WEBLATE_DEBUG: 1
WEBLATE_LOGLEVEL

Configura la verbositat del registre. Estableix-ho a DEBUG per obtenir registres més detallats.

El valor per defecte és INFO quan WEBLATE_DEBUG està desactivat, DEBUG s’utilitza quan el mode de depuració està activat.

Per a un registre més silenciós, utilitzeu ERROR o WARNING.

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
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 ADMINS com per crear un usuari admin (vegeu WEBLATE_ADMIN_PASSWORD per 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_NAME i WEBLATE_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.

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_HTTPS per 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:

  • auto per habilitar els oients IPv6 només quan IPv6 està disponible al temps d’execució del contenidor. Aquesta és la predeterminada.

  • activat per habilitar sempre els oients IPv6.

  • off per 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_PROXY i estableix IP_PROXY_HEADER.

When set to HTTP_X_FORWARDED_FOR, the bundled nginx resolves the client address using WEBLATE_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-For from 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-For s’assignaria a HTTP_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_HEADER is HTTP_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_HEADER is HTTP_X_FORWARDED_FOR, the bundled nginx forwards one normalized address and the container uses an effective offset of 0.

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é

USE_X_FORWARDED_PORT

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_LOGIN per imposar l’autenticació a tot el Weblate.

Exemple:

environment:
  WEBLATE_REQUIRE_LOGIN: 1

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-confirm to enable the legal module and enforce legal document confirmation during social authentication and for signed-in users.

  • wllegal per habilitar la mateixa integració i, addicionalment, carregar les plantilles de documents legals allotjades des de wllegal. 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

Configura LEGAL_DOCUMENT_CSS_CLASS als desplegaments de Docker amb WEBLATE_LEGAL_INTEGRATION activat.

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: ""

Configura LEGAL_HIDDEN_DOCUMENTS als desplegaments de Docker amb WEBLATE_LEGAL_INTEGRATION activat.

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é

DEFAULT_PULL_MESSAGE

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.

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 /translations or /tools/translations. Each segment can contain ASCII letters, digits, _, and -.

WEBLATE_STATIC_URL

Configura el prefix d’URL per als fitxers estàtics publicats des de CACHE_DIR.

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.

WEBLATE_API_RATELIMIT_ANON
WEBLATE_API_RATELIMIT_USER

Afegit a la versió 4.11.

Configures API_RATELIMIT_ANON and API_RATELIMIT_USER. Defaults to 100/day for anonymous and 5000/hour for authenticated users.

WEBLATE_API_RATELIMIT_USER_OVERRIDES
WEBLATE_API_RATELIMIT_IP_OVERRIDES

Afegit a la versió 2026.10.

JSON mappings configuring API_RATELIMIT_USER_OVERRIDES and API_RATELIMIT_IP_OVERRIDES. Both default to empty objects. Use JSON null to 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_ARGS com 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é

Privacy configuration

WEBLATE_PRIVATE_COMMIT_EMAIL_OPT_IN

Afegit a la versió 4.15.

Configura PRIVATE_COMMIT_EMAIL_OPT_IN.

Vegeu també

Privacy configuration

WEBLATE_PRIVATE_COMMIT_NAME_TEMPLATE

Afegit a la versió 5.16.

Configures PRIVATE_COMMIT_NAME_TEMPLATE.

Vegeu també

Privacy configuration

WEBLATE_PRIVATE_COMMIT_NAME_OPT_IN

Afegit a la versió 5.16.

Configures PRIVATE_COMMIT_NAME_OPT_IN.

Vegeu també

Privacy configuration

To use private commit e-mails and names by default, set both opt-in variables to False in docker-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 -d to 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 file scheme 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, or g suffix. The suffix is case-insensitive, and 0 disables 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_SIZE in bytes. When unset, follows WEBLATE_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_SIZE també 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.

WEBLATE_GITHUB_LEGACY_APP_WEBHOOK_SECRET

Afegit a la versió 2026.8.

Configures GITHUB_LEGACY_APP_WEBHOOK_SECRET. The _FILE variant 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.

WEBLATE_GITEA_USERNAME
WEBLATE_GITEA_TOKEN
WEBLATE_GITEA_HOST
WEBLATE_GITEA_CREDENTIALS

Configura Gitea pull requests canviant GITEA_CREDENTIALS.

WEBLATE_PAGURE_USERNAME
WEBLATE_PAGURE_TOKEN
WEBLATE_PAGURE_HOST
WEBLATE_PAGURE_CREDENTIALS

Configura Pagure merge requests canviant PAGURE_CREDENTIALS.

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.

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.

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_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)

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 earlier email default.

Suggeriment

Quan Keycloak està configurat per abstraure l’IDP de tercers, haureu de configurar WEBLATE_CSP_FORM_SRC per 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_KEY is unset; an explicit identifier, including sub, defaults to disabled. Set to 1 or 0 to 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
WEBLATE_SOCIAL_AUTH_SLACK_SECRET

Habilita l’autenticació Slack, vegeu Slack.

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 the oidc installation 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_ENABLED is 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, configure OAUTH2_PROVIDER in settings-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é

OIDC (OpenID Connect)

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 example https://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é

Weblate

Fedora OpenID Connect

Afegit a la versió 5.15.

WEBLATE_SOCIAL_AUTH_FEDORA_OIDC_KEY
WEBLATE_SOCIAL_AUTH_FEDORA_OIDC_SECRET

Configura la integració de Fedora OpenID Connect.

Vegeu també

Fedora

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 el requestedAuthnContext (necessari per a alguns proveïdors d’identitat, com ara Microsoft Entra ID amb autenticació multifactor):

environment:
  WEBLATE_SAML_SECURITY_CONFIG: '{"requestedAuthnContext": false}'
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.

WEBLATE_MIN_PASSWORD_SCORE

Puntuació mínima de la contrasenya avaluada per l’estimador de seguretat de la contrasenya zxcvbn. El valor predeterminat és 3, s’estableix en 0 per desactivar la comprovació de la força.

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.

POSTGRES_PASSWORD

Contrasenya PostgreSQL.

Vegeu també

Passing secrets

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

WEBLATE_DATABASE_BACKUP

Configura l’abocament diari de la base de dades mitjançant DATABASE_BACKUP. El valor predeterminat és plain.

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é

Passing secrets

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
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é

EMAIL_PORT

WEBLATE_EMAIL_HOST_USER

E-mail authentication user.

Vegeu també

EMAIL_HOST_USER

WEBLATE_EMAIL_HOST_PASSWORD

E-mail authentication password.

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.

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.

WEBLATE_EMAIL_BACKEND

Configura el back-end de Django per utilitzar-lo per enviar correus electrònics.

Set to django_ses.SESBackend to use AWS SES.

WEBLATE_AWS_SES_REGION_NAME

AWS region for SES (e.g. us-east-1). Sets AWS_SES_REGION_NAME and derives WEBLATE_AWS_SES_REGION_ENDPOINT automatically unless that variable is set explicitly. If not set, the region must be available through the standard boto3 credential chain (e.g. AWS_DEFAULT_REGION or 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 but WEBLATE_AWS_SES_REGION_NAME is provided, defaults to email.<region>.amazonaws.com. Override when using a VPC or custom endpoint.

WEBLATE_USE_SES_V2

Set to true to use the SES v2 API (SendEmail) instead of the legacy SendRawEmail call. 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_UPDATE for 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.

Configura LEGAL_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 és False.

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 és False.

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_HEADERS com a mapeig nom:valor separat per comes.

OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES

Configura OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES com a mapeig nom:valor separat 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, and WEB_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:

combined

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

split

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

single

Runs all queues in one process using the solo pool. This minimizes memory usage, but noticeably reduces task throughput.

Explicit WEBLATE_SERVICE selection 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 times WEBLATE_WORKERS. The worker uses a prefetch multiplier of one unless overridden here.

environment:
  CELERY_COMBINED_OPTIONS: --concurrency 12 --prefetch-multiplier 1
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 in combined or single mode, 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
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 to 1 without CELERY_WORKER_MODE, the container starts in single mode and logs a warning asking you to update the setting. If both variables are set, CELERY_WORKER_MODE takes precedence.

WEBLATE_ASGI

Afegit a la versió 2026.8.

Set to 1 to 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
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_WORKERS configures 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_WORKERS and is ignored when WEBLATE_ASGI is enabled.

The maximum number of simultaneous WSGI requests is approximately WEB_WORKERS multiplied by WEB_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-beat

Programador 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-backup

Treballador d’api per a còpies de seguretat, només s’hauria d’executar una instància.

celery-combined

Combined Celery worker for all task queues.

celery-celery

Treballador de l’api genèric.

celery-memory

Translation memory Celery worker.

celery-notify

Notifications Celery worker.

celery-single

Single-process Celery worker for all task queues.

celery-translate

Automatic translation Celery worker.

web

Servidor web.

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:// or https:// 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.

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.

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é

Customizing Weblate

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:

  1. Creeu un paquet Python personalitzat.

  2. 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.py amb el codi inicial següent:

    from weblate.settings_docker import *
    
  3. Creeu un Dockerfile personalitzat que hereta de la imatge oficial de Weblate Docker i, a continuació, instal·la el vostre paquet i dirigeix la variable d’entorn DJANGO_SETTINGS_MODULE al 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
    
  4. 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 afegir build: . al node weblate d’aquest fitxer, però aleshores la vostra imatge personalitzada s’etiquetarà com a weblate/weblate al vostre sistema, cosa que podria ser problemàtica.

    Per tant, en comptes d’utilitzar el docker-compose.yml directament des del repositori oficial, sense modificar-lo, i estendre’l mitjançant docker-compose.override.yml, potser voldreu fer una còpia del fitxer oficial docker-compose.yml per substituir el fitxer web docker-compose.yml per 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.

  5. 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_settings fa, 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.

An example of custom scheduled tasks in /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:

  1. Access the Weblate admin interface

  2. Navigate to Manage → Translation services

  3. 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é

WEBLATE_ANUBIS_URL

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_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