Telepítés Docker használatával¶
With dockerized Weblate deployment you can get your personal Weblate instance up and running in seconds. All of Weblate’s dependencies are already included. PostgreSQL is set up as the default database and Valkey as a caching backend.
Hardverkövetelmények¶
A Weblate bármilyen korszerű hardveren problémamentesen működik, az alábbi minimális konfiguráció szükséges a Weblate (adatbázis és webszerverrel együtt) egyetlen gépen történő futtatásához:
3 GB RAM
2 CPU mag
1 GB tárhely
Megjegyzés
A Weblate telepítésének tényleges követelményei nagymértékben függnek a kezelt fordítások méretétől.
Memóriahasználat¶
Minél több memória áll rendelkezésre, annál jobb – a memória minden szinten gyorsítótárazásra szolgál (fájlrendszer, adatbázis és Weblate). Több száz fordítási összetevő esetén legalább 4 GB RAM ajánlott.
Tipp
Ha kevesebb memória áll rendelkezésre, mint az ajánlott, a Egyszálú Celery beállítás használata javasolt.
CPU-használat¶
Sok egyidejű felhasználó esetén nő a szükséges CPU magok száma.
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.
Tárhelyhasználat¶
Az adatbázis tipikus tárhelyigénye körülbelül 300 MB 1 millió tárolt szóra vetítve.
A klónozott tárolók tárhelyigénye változó, de a Weblate igyekszik a méretüket minimálisra csökkenteni sekély (shallow ) klónozások alkalmazásával.
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.
Csomópontok¶
Kis és közepes méretű webhelyek esetén (milliós nagyságrendű tárolt szavak) az összes Weblate összetevő (lásd: Rendszer-architektúra áttekintése) egyetlen csomóponton is futtatható.
Amikor a tárolt szavak száma százmilliók fölé nő, ajánlott külön csomópontot biztosítani az adatbázis számára (lásd: Adatbázis beállítása Weblate-hez).
Telepítés¶
Tipp
A következő példák feltételezik, hogy működő Docker környezettel rendelkezik, és telepítve van a docker-compose-plugin. A részletes telepítési útmutatóért tekintse meg a Docker dokumentációját.
Ez a beállítás egy Weblate kiszolgálót hoz létre HTTP-n keresztül, ezért érdemes egy HTTPS-forgalmat lezáró (termináló) proxy mögé helyezni. Telepíthető közvetlenül HTTPS-proxyval is, erről bővebben lásd: Automatikus SSL tanúsítványok a Let’s Encrypt használatával. Nagyobb rendszerekhez tekintse meg a Vízszintes skálázás részt.
Klónozza a weblate-docker tárolót:
git clone https://github.com/WeblateOrg/docker-compose.git weblate-docker cd weblate-docker
Megjegyzés
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.
Hozza létre a saját beállításaival a
docker-compose.override.ymlfájlt. A környezeti változók teljes listáját lásd: Docker környezeti változók.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
Megjegyzés
Amennyiben a
WEBLATE_ADMIN_PASSWORDnincs beállítva, az adminisztrátor felhasználó véletlenszerű jelszóval jön létre, amely az első indításkor jelenik meg.A mellékelt példa alapján a Weblate a 80-as porton hallgatózik. Ha módosítani szeretné a port-hozzárendelést, szerkessze a
docker-compose.override.ymlfájlt.Indítsa el a Weblate-konténereket:
docker compose up
Élvezze a saját Weblate telepítését, amely a weblate konténer 80-as portján érhető el.
Lásd még
Docker-képtároló kiválasztása¶
A Weblate-konténerek az alábbi tárolókba kerülnek feltöltésre:
Docker Hub, lásd: https://hub.docker.com/r/weblate/weblate
GitHub Packages regiszter, lásd: https://github.com/WeblateOrg/docker/pkgs/container/weblate
Megjegyzés
Minden példában a Docker Hub-ról történik a képek letöltése, ha másik tárolót szeretne használni, módosítsa ennek megfelelően a konfigurációt.
Docker-kép címkéjének kiválasztása¶
Válasszon olyan címkét, amely megfelel a környezetének és elvárásainak:
Címke neve |
Leírás |
Használati eset |
|---|---|---|
|
Weblate stabil kiadás, amely megfelel a legutóbbi címkézett kiadásnak |
Folyamatos frissítések egy éles környezetben |
|
Weblate stabil kiadás |
Rolling updates within a calendar year in a production environment |
|
Weblate stabil kiadás |
Rolling updates within a monthly release in a production environment |
|
Weblate stabil kiadás |
Jól definiált telepítés éles környezetben |
|
Weblate stabil kiadás, amely fejlesztési változtatásokat is tartalmaz a Docker-konténerben (például frissített függőségek) |
Folyamatos frissítések tesztkörnyezetben |
|
Weblate stabil kiadás, amely fejlesztési változtatásokat is tartalmaz a Docker-konténerben (például frissített függőségek) |
Jól definiált telepítés tesztkörnyezetben |
|
Fejlesztői változat a Weblate Git tárolójából |
Rolling updates to test upcoming Weblate features |
|
Fejlesztői változat a Weblate Git tárolójából |
Jól definiált telepítés a közelgő Weblate funkciók tesztelésére |
Minden képet CI rendszerrel tesztelünk, mielőtt publikálnánk, így még a bleeding változat használata is viszonylag biztonságos.
A közzétett címkék teljes listája elérhető a GitHub Packages oldalon
Docker-konténer HTTPS támogatással¶
Az általános telepítési útmutatóért lásd: Telepítés. Ez a szakasz csak a különbségeket ismerteti.
SSL-t lezáró proxy¶
Az SSL kapcsolatot a Weblate-konténeren kívül is le lehet zárni. Ehhez több HTTP-fejlécet is továbbítani kell a konténer felé, hogy az tisztában legyen a tényleges környezetével. Ezeket a fejléceket részletesen a Fordított (reverse) proxy mögötti futtatás rész írja le.
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
Saját SSL tanúsítványok használata¶
Ha saját SSL tanúsítványt szeretne használni, egyszerűen helyezze el a fájlokat a Weblate adatkötetére (lásd: Docker-konténer kötetek):
ssl/fullchain.pemfájl tartalmazza a tanúsítványt és a szükséges CA (hitelesítésszolgáltatói) tanúsítványokatssl/privkey.pemfájl pedig a privát kulcsot tartalmazza
Mindkét fájlnak ugyanahhoz a felhasználóhoz kell tartoznia, aki a Docker-konténert indítja, és a fájlmaszknak 600 értékűnek kell lennie (csak a tulajdonos számára olvasható és írható).
Ezen felül a Weblate-konténer mostantól SSL-kapcsolatokat is fogad a 4443-as porton, ezért érdemes az HTTPS porttovábbítást is belefoglalni a Docker Compose felülírásba (override):
version: '3'
services:
weblate:
ports:
- 80:8080
- 443:4443
Ha ugyanazon a kiszolgálón más webhelyeket is üzemeltet, valószínű, hogy a 80 és 443 portokat már egy fordított proxy (például NGINX) használja. Ahhoz, hogy az NGINX-en keresztül átadja a HTTPS kapcsolatot a Docker-konténernek, a következő konfigurációt alkalmazhatja:
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>;
}
}
Cserélje ki a <SITE_URL>, <SITE> és <EXPOSED_DOCKER_PORT> értékeket a saját környezetének megfelelő adatokra.
Automatikus SSL tanúsítványok a Let’s Encrypt használatával¶
Ha nyilvános telepítés esetén automatikusan generált SSL tanúsítványokat szeretne használni a Let’s Encrypt szolgáltatással, akkor egy fordított HTTPS proxyval egészítse ki a rendszert egy további Docker-konténer segítségével. Ehhez az https-portal konténer használható. Ezt a docker-compose-https.yml fájl tartalmazza. Ezután hozza létre a saját beállításaival a docker-compose-https.override.yml fájlt:
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'
Valahányszor használja a docker compose parancsot, mindkét fájlt meg kell adni hozzá, majd hajtsa végre az alábbiakat:
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
Docker-konténer frissítése¶
Általában célszerű csak a Weblate-konténert frissíteni és a PostgreSQL-konténert az aktuális verzión tartani, mivel a PostgreSQL frissítése elég körülményes, és legtöbbször nem jár jelentős előnnyel.
Ezt úgy is megteheti, hogy a meglévő docker-compose fájlt használja, lehúzza a legfrissebb képeket, majd újraindítja a konténereket:
# 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
A Weblate adatbázis első indításkor automatikusan migrálásra kerül, nincs szükség további manuális beavatkozásra.
Megjegyzés
Direct upgrades are only supported for releases from the current or previous calendar year. If you need to upgrade from an older release, upgrade first to an intermediate version listed in Verzióspecifikus útmutatások.
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 PostgreSQL-konténer frissítése for upgrading the
PostgreSQL server.
PostgreSQL-konténer frissítése¶
Megjegyzés
PostgreSQL 18 changed the default data directory inside the container. A
common older setup mounted the database volume at
/var/lib/postgresql/data, while PostgreSQL 18 now uses
/var/lib/postgresql by default.
If you are upgrading from an older version, either update the mount target
in your Docker configuration to the new path, or keep the old mount target
and set PGDATA accordingly.
Leaving the old mount target unchanged without setting PGDATA can cause
PostgreSQL to write its data outside the persisted volume.
See PGDATA documentation for more information.
A PostgreSQL-konténerek nem támogatják a verziók közötti automatikus frissítést, a frissítést manuálisan kell elvégezni. Az alábbi lépések egy lehetséges módszert mutatnak be.
Állítsa le a Weblate-konténert:
docker compose stop weblate cache
Készítsen biztonsági mentést az adatbázisról:
docker compose exec database pg_dumpall --clean --if-exists --username weblate > backup.sql
Állítsa le az adatbázis konténert:
docker compose stop database
Távolítsa el a PostgreSQL kötetet:
docker compose rm -v database docker volume remove weblate-docker_postgres-data
Tipp
A kötet neve a Docker Compose projekt nevéből képződik, amely alapértelmezés szerint a könyvtár neve – ebben a dokumentációban ez
weblate-docker.Módosítsa a
docker-compose.ymlfájlt az új PostgreSQL verzió használatára.Indítsa el az adatbázis-konténert:
docker compose up -d database
Állítsa vissza az adatbázist a biztonsági mentésből:
cat backup.sql | docker compose exec -T database psql --username weblate --dbname weblate
Tipp
Ellenőrizze, hogy az adatbázis neve megegyezik-e a
POSTGRES_DBértékével.(Opcionális) Frissítse a Weblate felhasználó jelszavát. Ez szükséges lehet a PostgreSQL 14-es vagy 15-ös verziójára történő migráció során, mivel megváltozott a jelszavak tárolásának módja:
docker compose exec -T database psql --username weblate --dbname weblate -c "ALTER USER weblate WITH PASSWORD 'weblate'"
Tipp
Ellenőrizze, hogy az adatbázis neve megegyezik-e a
POSTGRES_DBértékével.Indítsa el az összes fennmaradó konténert:
docker compose up -d
Adminisztrátori bejelentkezés¶
A konténerek beállítása után jelentkezzen be admin felhasználóként a WEBLATE_ADMIN_PASSWORD változóban megadott jelszóval vagy ha az nem volt beállítva, az első indításkor generált véletlenszerű jelszóval.
Az admin jelszó visszaállításához indítsa újra a konténert úgy, hogy a WEBLATE_ADMIN_PASSWORD változóban megadja az új jelszót.
Folyamatok száma és memóriahasználat¶
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.
Ha sok CPU mag áll rendelkezésére, de memóriahiányt tapasztal, próbálja meg csökkenteni a munkafolyamatok számát:
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
Vízszintes skálázás¶
Added in version 4.6.
A szolgáltatás vízszintes skálázása érdekében több Weblate-konténert is futtathat. A /app/data kötetet közösen kell használniuk a konténereknek – ehhez ajánlott klaszterezett fájlrendszert, például GlusterFS-t alkalmazni. A /app/cache kötet viszont konténerenként külön példányban szükséges.
Minden Weblate-konténer szerepe a WEBLATE_SERVICE környezeti változóval van meghatározva. Kövesse figyelmesen a dokumentációt, mivel bizonyos szolgáltatásokat csak egyszer szabad futtatni a klaszterben, és a szolgáltatások indítási sorrendje is fontos.
Példabeállítást talál a docker-compose tárolóban: 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 Teljesítményjelentés
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.
Docker környezeti változók¶
A Weblate számos konfigurációs beállítása megadható a Docker-konténerben az alább ismertetett környezeti változók használatával.
Ha olyan beállítást kell megadnia, amely nem érhető el Docker környezeti változón keresztül, lásd: Konfiguráció a környezeti változókon túl.
Titkos adatok átadása (passing secrets)¶
Added in version 5.0.
A Weblate-konténer támogatja a titkos adatok fájlon keresztüli átadását. Ehhez adja hozzá a környezeti változó nevéhez a _FILE utótagot, és adja át a titkos fájlt a Docker-konténernek.
A kapcsolódó docker-compose.yml például így nézhet ki:
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
Általános beállítások¶
- WEBLATE_DEBUG¶
A Django hibakeresési módját a
DEBUGbeállításával konfigurálja.Példa:
environment: WEBLATE_DEBUG: 1
- WEBLATE_LOGLEVEL¶
A naplózás részletességi szintjét szabályozza. Állítsa
DEBUGértékre a részletesebb naplók megtekintéséhez.Alapértelmezés szerint
INFOszintre van állítva, amikor aWEBLATE_DEBUGki van kapcsolva, ésDEBUGszintre, amikor a hibakeresési mód be van kapcsolva.Ha csendesebb naplózást szeretne, használja az
ERRORvagyWARNINGszinteket.
- WEBLATE_LOGLEVEL_DATABASE¶
Az adatbázis-lekérdezések naplózásának részletességét szabályozza.
- WEBLATE_LOG_GELF_HOST¶
Added in version 5.9.
Távoli naplózást konfigurál GELF TCP kapcsolaton keresztül. Használható például Graylog integrációhoz.
- WEBLATE_LOG_GELF_PORT¶
Added in version 5.9.
Egyedi portot is beállíthat a
WEBLATE_LOG_GELF_HOSTszámára, alapértelmezésben a 12201 portot használja.
- WEBLATE_SITE_TITLE¶
Megváltoztatja a webhely-címet, amely az összes oldal fejlécében jelenik meg.
- 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.
Példa:
environment: WEBLATE_SITE_DOMAIN: example.com:8080
- WEBLATE_ADMIN_NAME¶
- WEBLATE_ADMIN_EMAIL¶
A webhely adminisztrátorának nevét és e-mail címét állítja be. Ez az
ADMINSbeállításhoz, valamint az admin felhasználó létrehozásához is használatos (további részletekért lásd:WEBLATE_ADMIN_PASSWORD).Példa:
environment: WEBLATE_ADMIN_NAME: Weblate admin WEBLATE_ADMIN_EMAIL: noreply@example.com
- WEBLATE_ADMIN_PASSWORD¶
Az admin felhasználó jelszavát állítja be.
Ha nincs beállítva, és az admin felhasználó nem létezik, a rendszer véletlenszerű jelszóval hozza létre az első konténerindításkor.
Ha nincs beállítva, de az admin felhasználó létezik, nem történik semmilyen módosítás.
Ha be van állítva, az admin felhasználó minden konténerindításkor frissítésre kerül, hogy megfeleljen a
WEBLATE_ADMIN_PASSWORD,WEBLATE_ADMIN_NAMEésWEBLATE_ADMIN_EMAILértékeknek.
Figyelem
Biztonsági kockázatot jelenthet a jelszó tárolása a konfigurációs fájlban. Ezt a változót érdemes csak a kezdeti beállításhoz használni (vagy hagyni, hogy a Weblate automatikusan véletlenszerű jelszót generáljon az első indításkor), illetve jelszó-visszaállításhoz.
- WEBLATE_ADMIN_NOTIFY_ERROR¶
Whether to send e-mail to admins upon server error. Turned on by default.
Előfordulhat, hogy inkább más hibagyűjtő rendszert, például a Sentryt vagy a Rollbart szeretné használni, ebben az esetben érdemes ezt a funkciót kikapcsolni.
Lásd még
- WEBLATE_SERVER_EMAIL¶
Az e-mail cím, ahonnan a hibajelentések küldésre kerülnek.
- WEBLATE_DEFAULT_FROM_EMAIL¶
A kimenő e-mailek küldő címét állítja be.
- WEBLATE_ADMINS_CONTACT¶
Az
ADMINS_CONTACTbeállítását konfigurálja.
- WEBLATE_CONTACT_FORM¶
A kapcsolatfelvételi űrlap viselkedését állítja be, lásd:
CONTACT_FORM.
- WEBLATE_ALLOWED_HOSTS¶
Az engedélyezett HTTP hosztneveket állítja be az
ALLOWED_HOSTSsegítségével.Alapértelmezés szerint
*, amely minden hosztnevet engedélyez.Példa:
environment: WEBLATE_ALLOWED_HOSTS: weblate.example.com,example.com
- WEBLATE_REGISTRATION_OPEN¶
A regisztrációs lehetőség elérhetőségét szabályozza a
REGISTRATION_OPENállításával.Példa:
environment: WEBLATE_REGISTRATION_OPEN: 0
- WEBLATE_REGISTRATION_CAPTCHA¶
Added in version 5.10.
Beállítja, hogy a regisztrációhoz és egyéb hitelesítést nem igénylő műveletekhez használjon-e captcha-t, lásd:
REGISTRATION_CAPTCHA.Példa:
environment: WEBLATE_REGISTRATION_CAPTCHA: 0
- WEBLATE_REGISTRATION_ALLOW_BACKENDS¶
Beállítja, hogy mely hitelesítési módszerek használhatók új fiók létrehozására a
REGISTRATION_ALLOW_BACKENDSsegítségével.Példa:
environment: WEBLATE_REGISTRATION_OPEN: 0 WEBLATE_REGISTRATION_ALLOW_BACKENDS: azuread-oauth2,azuread-tenant-oauth2
- WEBLATE_REGISTRATION_REBIND¶
Added in version 4.16.
A
REGISTRATION_REBINDbeállítását konfigurálja.
- WEBLATE_REGISTRATION_ALLOW_DISPOSABLE_EMAILS¶
Added in version 5.16.1.
Configures
REGISTRATION_ALLOW_DISPOSABLE_EMAILS.Példa:
environment: WEBLATE_REGISTRATION_ALLOW_DISPOSABLE_EMAILS: 1
- WEBLATE_PROJECT_WEB_RESTRICT_PRIVATE¶
Added in version 5.17.
Configures
PROJECT_WEB_RESTRICT_PRIVATE.Defaults to enabled.
- WEBLATE_PROJECT_WEB_RESTRICT_ALLOWLIST¶
Added in version 5.17.
Configures
PROJECT_WEB_RESTRICT_ALLOWLIST.Expects a comma-separated list of trusted project slugs.
- WEBLATE_WEBHOOK_RESTRICT_PRIVATE¶
Added in version 5.17.
Configures
WEBHOOK_RESTRICT_PRIVATE.Defaults to enabled.
- WEBLATE_WEBHOOK_PRIVATE_ALLOWLIST¶
Added in version 5.17.
Configures
WEBHOOK_PRIVATE_ALLOWLIST.Expects a comma-separated list of trusted hostnames or domains.
- WEBLATE_ALLOWED_ASSET_SIZE¶
Added in version 2025.7.
Configures
ALLOWED_ASSET_SIZE.
- WEBLATE_ASSET_RESTRICT_PRIVATE¶
Added in version 2025.5.
Configures
ASSET_RESTRICT_PRIVATE.Defaults to enabled.
- WEBLATE_ASSET_PRIVATE_ALLOWLIST¶
Added in version 2025.5.
Configures
ASSET_PRIVATE_ALLOWLIST.Expects a comma-separated list of trusted hostnames or domains.
- WEBLATE_TIME_ZONE¶
A Weblate által használt időzónát állítja be, lásd:
TIME_ZONE.Megjegyzés
Ha a Docker-konténer időzónáját szeretné megváltoztatni, használja a
TZkörnyezeti változót.Példa:
environment: WEBLATE_TIME_ZONE: Europe/Prague
- WEBLATE_ENABLE_HTTPS¶
Beállítja, hogy a Weblate feltételezze, hogy egy fordított (reverse) HTTPS proxy mögött működik, így HTTPS-t használ az e-mailekben és az API linkekben, illetve biztonsági jelzőket állít be a sütiknél.
Tipp
Az esetleges problémák miatt tekintse meg az
ENABLE_HTTPSdokumentációját.Megjegyzés
Ez önmagában nem teszi lehetővé, hogy a Weblate-konténer közvetlenül HTTPS kapcsolaton keresztül fogadjon kéréseket, ehhez külön konfiguráció szükséges. Ezekre példákat itt talál: Docker-konténer HTTPS támogatással.
Példa:
environment: WEBLATE_ENABLE_HTTPS: 1
- WEBLATE_NGINX_IPV6¶
Added in version 5.17.
Controls whether the bundled NGINX listens on IPv6 addresses.
Supported values are:
autoto enable IPv6 listeners only when IPv6 is available in the container runtime. This is the default.onto always enable IPv6 listeners.offto disable IPv6 listeners.
Példa:
environment: WEBLATE_NGINX_IPV6: auto
- WEBLATE_IP_PROXY_HEADER¶
Lehetővé teszi, hogy a Weblate egy megadott HTTP fejlécből olvassa ki az IP címet. Ezt akkor használja, ha a Weblate-konténer előtt fordított proxy működik.
Engedélyezi az
IP_BEHIND_REVERSE_PROXYfunkciót, és beállítja azIP_PROXY_HEADERértékét.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.A 2026.9 verzióban változott: The bundled nginx no longer trusts
X-Forwarded-Forfrom all network addresses. Trusted proxy addresses have to be configured explicitly.Megjegyzés
A megadott formátumnak meg kell felelnie a Django által elvárt szabályoknak. A Django a nyers HTTP-fejlécneveket az alábbiak szerint alakítja át:
az összes karaktert nagybetűssé alakítja
a kötőjeleket aláhúzásjelekké cseréli
HTTP_előtagot ad a név elé
Így például az
X-Forwarded-ForfejlécbőlHTTP_X_FORWARDED_FORlesz.Példa:
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¶
Added in version 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.
Példa:
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¶
Added in version 5.0.1.
Az
IP_PROXY_OFFSETbeállítását konfigurálja.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¶
Added in version 5.0.1.
Egy logikai érték, amely meghatározza, hogy az X-Forwarded-Port fejlécet használja-e a SERVER_PORT META változó helyett. Ezt csak akkor szabad engedélyezni, ha olyan proxy van használatban, amely beállítja ezt a fejlécet.
Lásd még
Megjegyzés
Ez egy logikai típusú beállítás (
"true"vagy"false"értékkel).
- WEBLATE_SECURE_PROXY_SSL_HEADER¶
A tuple representing an HTTP header/value combination that signifies a request is secure. This is needed when Weblate is running behind a reverse proxy doing SSL termination which does not pass standard HTTPS headers.
Példa:
environment: WEBLATE_SECURE_PROXY_SSL_HEADER: HTTP_X_FORWARDED_PROTO,https
- WEBLATE_REQUIRE_LOGIN¶
A
REQUIRE_LOGINbeállításának engedélyezésével kötelezővé teheti a bejelentkezést a teljes Weblate telepítésre.Példa:
environment: WEBLATE_REQUIRE_LOGIN: 1
- WEBLATE_LEGAL_INTEGRATION¶
Enables the Jogi modul module in Docker deployments. By default, the integration is disabled; leave this variable unset or empty to disable it.
Supported values are:
tos-confirmto enable the legal module and enforce legal document confirmation during social authentication and for signed-in users.wllegalto enable the same integration and additionally load the hosted legal document templates fromwllegal. These templates are used by services operated by Weblate s.r.o. and are not intended for general use.
To provide your own legal documents in Docker, override the templates in
/app/data/python/customize/templates/legal/documents, see Logó és egyéb statikus fájlok cseréje.Recreate the Docker container after changing this environment variable, for example using docker compose up -d. Restarting an existing container does not apply changed environment values.
Példa:
environment: WEBLATE_LEGAL_INTEGRATION: tos-confirm
- WEBLATE_LEGAL_DOCUMENT_CSS_CLASS¶
Configures
LEGAL_DOCUMENT_CSS_CLASSin Docker deployments withWEBLATE_LEGAL_INTEGRATIONenabled.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.
Példa:
environment: WEBLATE_LEGAL_DOCUMENT_CSS_CLASS: ""
- WEBLATE_LEGAL_HIDDEN_DOCUMENTS¶
Configures
LEGAL_HIDDEN_DOCUMENTSin Docker deployments withWEBLATE_LEGAL_INTEGRATIONenabled.Provide a comma-separated list of legal document page identifiers.
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:
Példa:
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¶
A Google Analytics azonosítót a
GOOGLE_ANALYTICS_IDmegváltoztatásával konfigurálja.
- WEBLATE_DEFAULT_PULL_MESSAGE¶
Az alapértelmezett cím és üzenet beállítása az API-n keresztül történő módosítási kérelmekhez (pull requests) a
DEFAULT_PULL_MESSAGEmódosításával történik.Lásd még
- WEBLATE_SIMPLIFY_LANGUAGES¶
A nyelvi egyszerűsítési szabályokat a
SIMPLIFY_LANGUAGESsegítségével állíthatja be.
- WEBLATE_HIDE_SHARED_GLOSSARY_COMPONENTS¶
Hides glossary components when shared to other projects, see
HIDE_SHARED_GLOSSARY_COMPONENTS.
- WEBLATE_DEFAULT_ACCESS_CONTROL¶
Új projektekhez az alapértelmezett Hozzáférés-vezérlés beállítást a
DEFAULT_ACCESS_CONTROLmódosításával konfigurálja.
- WEBLATE_DEFAULT_TRANSLATION_REVIEW¶
Added in version 5.16.
Configures the default value for Felülvizsgálatok engedélyezése, turned off by default.
- WEBLATE_DEFAULT_SOURCE_REVIEW¶
Added in version 5.16.
Configures the default value for Forrás-felülvizsgálatok engedélyezése, turned off by default.
- WEBLATE_DEFAULT_RESTRICTED_COMPONENT¶
Új összetevőknél a Korlátozott hozzáférés alapértelmezett értékét a
DEFAULT_RESTRICTED_COMPONENTbeállítás szabályozza.
- WEBLATE_DEFAULT_TRANSLATION_PROPAGATION¶
Új összetevőknél a Fordítások terjesztésének engedélyezése alapértelmezett értékét a
DEFAULT_TRANSLATION_PROPAGATIONbeállítás szabályozza.
- WEBLATE_DEFAULT_COMMITER_EMAIL¶
Az alapértelmezett
DEFAULT_COMMITER_EMAILértékét konfigurálja.
- WEBLATE_DEFAULT_COMMITER_NAME¶
A
DEFAULT_COMMITER_NAMEértékét konfigurálja.
- WEBLATE_DEFAULT_SHARED_TM¶
A
DEFAULT_SHARED_TMértékét konfigurálja.
- WEBLATE_DEFAULT_AUTOCLEAN_TM¶
Configures
DEFAULT_AUTOCLEAN_TM.
- WEBLATE_COMMIT_PENDING_HOURS¶
Configures the default value for Változások kora véglegesítéshez for new components, see
COMMIT_PENDING_HOURS.
- WEBLATE_GPG_IDENTITY¶
A véglegesítések GPG-aláírását konfigurálja, lásd:
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/translationsor/tools/translations. Each segment can contain ASCII letters, digits,_, and-.
- WEBLATE_SILENCED_SYSTEM_CHECKS¶
A nem kívánt ellenőrzések megjelenítését konfigurálja, lásd:
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¶
A Content-Security-Policy HTTP fejléc testreszabását teszi lehetővé.
- WEBLATE_LICENSE_FILTER¶
A
LICENSE_FILTERértékét konfigurálja.
- WEBLATE_LICENSE_REQUIRED¶
A
LICENSE_REQUIREDértékét konfigurálja.
- WEBLATE_WEBSITE_REQUIRED¶
A
WEBSITE_REQUIREDértékét konfigurálja.
- WEBLATE_VERSION_DISPLAY¶
Configures
VERSION_DISPLAY.
- WEBLATE_HIDE_VERSION¶
A
HIDE_VERSIONértékét konfigurálja.
- WEBLATE_BASIC_LANGUAGES¶
A
BASIC_LANGUAGESértékét konfigurálja.
- WEBLATE_DEFAULT_AUTO_WATCH¶
A
DEFAULT_AUTO_WATCHértékét konfigurálja.
- WEBLATE_DEFAULT_NOTIFICATIONS¶
Added in version 2026.10.1.
Configures
DEFAULT_NOTIFICATIONS.Példa:
environment: WEBLATE_DEFAULT_NOTIFICATIONS: 0:1:MentionCommentNotificaton,10:1:LastAuthorCommentNotificaton
- WEBLATE_RATELIMIT_ATTEMPTS¶
- WEBLATE_RATELIMIT_LOCKOUT¶
- WEBLATE_RATELIMIT_WINDOW¶
Added in version 4.6.
A sebességkorlátozás (rate limiter) konfigurálását végzi.
Tipp
Bármely sebességkorlátozási tartomány beállítását megadhatja. Ehhez adjon
WEBLATE_előtagot a Sebességkorlátozás részben ismertetett bármely beállításhoz.
- WEBLATE_API_RATELIMIT_ANON¶
- WEBLATE_API_RATELIMIT_USER¶
Added in version 4.11.
Configures
API_RATELIMIT_ANONandAPI_RATELIMIT_USER. Defaults to100/dayfor anonymous and5000/hourfor authenticated users.Lásd még
- WEBLATE_API_RATELIMIT_USER_OVERRIDES¶
- WEBLATE_API_RATELIMIT_IP_OVERRIDES¶
Added in version 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 API lekérdezési korlátozás for counting behavior and proxy configuration requirements.
- WEBLATE_ENABLE_HOOKS¶
Added in version 4.13.
Az
ENABLE_HOOKSértékét konfigurálja.
- WEBLATE_ENABLE_AVATARS¶
Added in version 4.6.1.
Az
ENABLE_AVATARSértékét konfigurálja.
- WEBLATE_AVATAR_URL_PREFIX¶
Added in version 4.15.
A
AVATAR_URL_PREFIXértékét konfigurálja.
- WEBLATE_AVATAR_URL_TEMPLATE¶
Added in version 2026.10.
Configures
AVATAR_URL_TEMPLATE.
- WEBLATE_LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH¶
Added in version 4.9.
A
LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTHértékét konfigurálja.
- WEBLATE_SSH_EXTRA_ARGS¶
Added in version 4.9.
Az
SSH_EXTRA_ARGSértékét konfigurálja.
- WEBLATE_BORG_EXTRA_ARGS¶
Added in version 4.9.
A
BORG_EXTRA_ARGSértékét konfigurálja, vesszővel elválasztott argumentumok listájaként.Példa:
environment: WEBLATE_BORG_EXTRA_ARGS: --exclude,vcs/
- WEBLATE_ENABLE_SHARING¶
Added in version 4.14.1.
Az
ENABLE_SHARINGértékét konfigurálja.
- WEBLATE_SUPPORT_STATUS_CHECK¶
Added in version 5.5.
A
SUPPORT_STATUS_CHECKértékét konfigurálja.
- WEBLATE_EXTRA_HTML_HEAD¶
Added in version 4.15.
Az
EXTRA_HTML_HEADértékét konfigurálja.
- WEBLATE_INTERNAL_BOT_EMAIL_TEMPLATE¶
Added in version 2026.7.1.
Configures
INTERNAL_BOT_EMAIL_TEMPLATE.
- WEBLATE_PRIVATE_COMMIT_EMAIL_TEMPLATE¶
Added in version 4.15.
A
PRIVATE_COMMIT_EMAIL_TEMPLATEértékét konfigurálja.
- WEBLATE_PRIVATE_COMMIT_EMAIL_OPT_IN¶
Added in version 4.15.
A
PRIVATE_COMMIT_EMAIL_OPT_INértékét konfigurálja.
- WEBLATE_PRIVATE_COMMIT_NAME_TEMPLATE¶
Added in version 5.16.
Configures
PRIVATE_COMMIT_NAME_TEMPLATE.
- WEBLATE_PRIVATE_COMMIT_NAME_OPT_IN¶
Added in version 5.16.
Configures
PRIVATE_COMMIT_NAME_OPT_IN.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" WEBLATE_PRIVATE_COMMIT_EMAIL_TEMPLATE: "user-{user_id}@users.noreply.{site_domain}" WEBLATE_PRIVATE_COMMIT_NAME_TEMPLATE: "{site_title} user {user_id}"
The template variables are optional customizations. This e-mail template uses the user ID instead of the username included in the default template. 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¶
Added in version 4.17.
A
UNUSED_ALERT_DAYSértékét konfigurálja.
- WEBLATE_REPORT_EXPIRY¶
Added in version 2026.8.
Configures
REPORT_EXPIRY.
- WEBLATE_UPDATE_LANGUAGES¶
Added in version 4.3.2.
A
UPDATE_LANGUAGESértékét konfigurálja.
- WEBLATE_VCS_ALLOW_HOSTS¶
Added in version 5.15.
Configures
VCS_ALLOW_HOSTS.
- WEBLATE_VCS_PRIVATE_ALLOWLIST¶
Added in version 2026.9.
Configures
VCS_PRIVATE_ALLOWLIST.
- WEBLATE_VCS_ALLOW_SCHEMES¶
Added in version 5.15.
Configures
VCS_ALLOW_SCHEMES.The
filescheme is disabled for security reasons. Including it prevents Weblate from starting.
- WEBLATE_VCS_RESTRICT_PRIVATE¶
Added in version 5.17.
Configures
VCS_RESTRICT_PRIVATE.
- WEBLATE_VCS_CLONE_DEPTH¶
Added in version 5.4.
Configures
VCS_CLONE_DEPTH.
- WEBLATE_VCS_API_DELAY¶
Added in version 5.4.
Configures
VCS_API_DELAY.
- WEBLATE_VCS_API_TIMEOUT¶
Added in version 5.15.
Configures
VCS_API_TIMEOUT.
- WEBLATE_CORS_ALLOWED_ORIGINS¶
Added in version 4.16.
A CORS kérések API-hoz történő engedélyezését konfigurálja megadott forrásokból.
Példa:
environment: WEBLATE_CORS_ALLOWED_ORIGINS: https://example.com,https://weblate.org
- WEBLATE_CORS_ALLOW_ALL_ORIGINS¶
Added in version 5.6.1: A CORS kérések API-hoz történő engedélyezését konfigurálja minden forrásból.
- WEBLATE_WEBSITE_ALERTS_ENABLED¶
Added in version 5.17.
Configures
WEBSITE_ALERTS_ENABLED.
- CLIENT_MAX_BODY_SIZE¶
Added in version 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
Tipp
Ezt a változót szándékosan nem előzi meg a
WEBLATE_előtag, mivel a Automatikus SSL tanúsítványok a Let’s Encrypt használatával során használt külső konténerrel közösen használatos.
- 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.The value is in bytes. Make sure
CLIENT_MAX_BODY_SIZEis also large enough for uploaded backup files.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS¶
Added in version 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MAX_MEMBERS.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE¶
Added in version 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE.The value is in bytes.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE¶
Added in version 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE.The value is in bytes.
- WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE¶
Added in version 2026.5.
Configures
PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE.The value is in bytes.
- WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO¶
Added in version 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 módosítási kérelmek (pull request), but apply to all Verziókezelő integráció with appropriately changed variable names.
Fontos
All environment variable names must include the WEBLATE_ prefix. For example,
to configure GitHub credentials, use WEBLATE_GITHUB_USERNAME, not GITHUB_USERNAME.
This applies whether you’re configuring for pull requests or any other VCS integration.
An example configuration for GitHub pull requests might look like:
WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com
Felhasználás módja:
GITHUB_CREDENTIALS = {
"api.github.com": {
"username": "api-user",
"token": "api-token",
}
}
Alternatív megoldásként a Python-szótár szövegként is megadható:
WEBLATE_GITHUB_CREDENTIALS='{ "api.github.com": { "username": "api-user", "token": "api-token", } }'
Vagy egy fájl útvonala is megadható, amely a Python-szótárt tartalmazza:
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¶
Configures GitHub módosítási kérelmek (pull request) by changing
GITHUB_CREDENTIALS.
- WEBLATE_GITHUB_LEGACY_APP_WEBHOOK_SECRET¶
Added in version 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¶
Configures GitLab egyesítési kérelmek (merge request) by changing
GITLAB_CREDENTIALS.
- WEBLATE_GITEA_USERNAME¶
- WEBLATE_GITEA_TOKEN¶
- WEBLATE_GITEA_HOST¶
- WEBLATE_GITEA_CREDENTIALS¶
Configures Gitea módosítási kérelmek (pull request) by changing
GITEA_CREDENTIALS.
- WEBLATE_PAGURE_USERNAME¶
- WEBLATE_PAGURE_TOKEN¶
- WEBLATE_PAGURE_HOST¶
- WEBLATE_PAGURE_CREDENTIALS¶
Configures Pagure egyesítési kérelmek (merge request) by changing
PAGURE_CREDENTIALS.
- WEBLATE_BITBUCKETSERVER_USERNAME¶
- WEBLATE_BITBUCKETSERVER_TOKEN¶
- WEBLATE_BITBUCKETSERVER_HOST¶
- WEBLATE_BITBUCKETSERVER_CREDENTIALS¶
Configures Bitbucket Data Center módosítási kérelmek (pull request) by changing
BITBUCKETSERVER_CREDENTIALS.
- WEBLATE_BITBUCKETCLOUD_USERNAME¶
- WEBLATE_BITBUCKETCLOUD_WORKSPACE¶
- WEBLATE_BITBUCKETCLOUD_TOKEN¶
- WEBLATE_BITBUCKETCLOUD_HOST¶
- WEBLATE_BITBUCKETCLOUD_CREDENTIALS¶
Configures Bitbucket Cloud módosítási kérelmek (pull request) by changing
BITBUCKETCLOUD_CREDENTIALS.
- WEBLATE_AZURE_DEVOPS_USERNAME¶
- WEBLATE_AZURE_DEVOPS_ORGANIZATION¶
- WEBLATE_AZURE_DEVOPS_TOKEN¶
- WEBLATE_AZURE_DEVOPS_HOST¶
- WEBLATE_AZURE_DEVOPS_CREDENTIALS¶
Configures Azure DevOps egyesítési kérelmek (pull request) by changing
AZURE_DEVOPS_CREDENTIALS.
Translation services settings¶
A 4.13 verzióban változott: Translation services are now configured in the user interface, see Translation services.
A meglévő környezeti változók Weblate 4.13 verzióra történő frissítéskor automatikusan importálásra kerülnek, későbbi módosításuk azonban már nem lesz hatással a működésre.
Hitelesítési beállítások¶
Tipp
The e-mail based authentication is turned on unless disabled by 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¶
LDAP hitelesítés konfigurálása.
Példa közvetlen kötésre:
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
Példa keresésre és kötésre:
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
Példa uniós keresésre és kötésre:
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
Példa keresésre és kötésre Active Directory használatával:
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¶
A GitHub hitelesítés engedélyezése.
GitHub Enterprise kiadás¶
- 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¶
A GitHub EE hitelesítés engedélyezése.
Bitbucket¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_SECRET¶
A Bitbucket hitelesítés engedélyezése.
Facebook¶
- WEBLATE_SOCIAL_AUTH_FACEBOOK_KEY¶
- WEBLATE_SOCIAL_AUTH_FACEBOOK_SECRET¶
A Facebook OAuth 2 engedélyezése.
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¶
A Google OAuth 2 engedélyezése.
GitLab¶
- WEBLATE_SOCIAL_AUTH_GITLAB_KEY¶
- WEBLATE_SOCIAL_AUTH_GITLAB_SECRET¶
- WEBLATE_SOCIAL_AUTH_GITLAB_API_URL¶
A GitLab OAuth 2 engedélyezése.
Gitea¶
- WEBLATE_SOCIAL_AUTH_GITEA_API_URL¶
- WEBLATE_SOCIAL_AUTH_GITEA_KEY¶
- WEBLATE_SOCIAL_AUTH_GITEA_SECRET¶
A Gitea-hitelesítés engedélyezése.
Microsoft Entra ID¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_SECRET¶
Enables Microsoft Entra ID authentication, see Microsoft Entra ID.
Microsoft Entra ID with Tenant support¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_KEY¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_SECRET¶
- WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_TENANT_ID¶
Enables Microsoft Entra ID authentication with Tenant support, see Microsoft Entra ID.
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¶
A Keycloak-hitelesítés engedélyezése, lásd: Keycloak - Open Source Red Hat SSO.
- WEBLATE_SOCIAL_AUTH_KEYCLOAK_ID_KEY¶
Added in version 5.17.
Configures which claim is used as the unique user identifier from Keycloak. Defaults to
email.Tipp
When Keycloak is configured to abstract third-party IDP, you will need to configure
WEBLATE_CSP_FORM_SRCfor the third-party IDP domain.Example when Keycloak is passing authentication to Microsoft.¶environment: WEBLATE_CSP_FORM_SRC: login.microsoftonline.com
Linux-forgalmazók¶
A Linux-forgalmazók hitelesítési szolgáltatásainak használata engedélyezhető a megfelelő változók tetszőleges értékre állításával.
- WEBLATE_SOCIAL_AUTH_FEDORA¶
- WEBLATE_SOCIAL_AUTH_OPENSUSE¶
- WEBLATE_SOCIAL_AUTH_OPENINFRA¶
- WEBLATE_SOCIAL_AUTH_UBUNTU¶
Slack¶
- WEBLATE_SOCIAL_AUTH_SLACK_KEY¶
OpenID Connect¶
Added in version 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¶
Általános OpenID Connect integráció konfigurálása.
Lásd még
Fedora OpenID Connect¶
Added in version 5.15.
- WEBLATE_SOCIAL_AUTH_FEDORA_OIDC_KEY¶
SAML¶
Az önaláírt SAML kulcsok az első konténer indításkor automatikusan létrejönnek. Ha saját kulcsokat kíván használni, helyezze el a tanúsítványt és a privát kulcsot a következő helyekre: /app/data/ssl/saml.crt és /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¶
SAML Identity Provider beállítások, lásd: SAML-hitelesítés.
- WEBLATE_SAML_SECURITY_CONFIG¶
Added in version 2026.6.
SAML security configuration as a JSON object, passed to
SOCIAL_AUTH_SAML_SECURITY_CONFIG. For example, to disable therequestedAuthnContext(needed for some identity providers such as Microsoft Entra ID with multi-factor authentication):environment: WEBLATE_SAML_SECURITY_CONFIG: '{"requestedAuthnContext": false}'
Lásd még
- 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¶
Added in version 4.18.
SAML attribútumok hozzárendelése (mapping).
Egyéb hitelesítési beállítások¶
- WEBLATE_NO_EMAIL_AUTH¶
Bármilyen értékre állítva letiltja az e-mailes hitelesítést. Lásd: Jelszavas hitelesítés kikapcsolása.
PostgreSQL adatbázis beállítása¶
Az adatbázist a docker-compose.yml hozza létre, így ezek a beállítások a Weblate- és a PostgreSQL-konténerekre egyaránt érvényesek.
Lásd még
- POSTGRES_PASSWORD¶
PostgreSQL jelszó.
- POSTGRES_USER¶
PostgreSQL felhasználónév.
- POSTGRES_DB¶
PostgreSQL adatbázisnév.
- POSTGRES_HOST¶
PostgreSQL szerver hosztneve vagy IP-címe. Alapértelmezés:
database.
- POSTGRES_PORT¶
PostgreSQL szerver portja. Alapértelmezés szerint nincs megadva (az alapértelmezett értéket használja).
- POSTGRES_SSL_MODE¶
Meghatározza, hogyan kezelje a PostgreSQL az SSL-kapcsolatokat. A választható módokról bővebben: SSL Mode Descriptions.
- POSTGRES_ALTER_ROLE¶
Annak a PostgreSQL szerepkörnek a nevét adja meg, amelyet az adatbázis-migráció során módosítani kell. Lásd: Weblate konfigurálása PostgreSQL használatára.
Alapértelmezett érték:
POSTGRES_USER.
- POSTGRES_CONN_MAX_AGE¶
Added in version 4.8.1.
Az adatbázis-kapcsolat élettartama másodpercben. 0 esetén a kapcsolat minden kérés végén bezáródik.
A 5.1 verzióban változott: Alapértelmezés szerint a kapcsolatok időkorlát nélkül fennmaradnak.
A kapcsolat folyamatos fenntartásának engedélyezése több nyitott kapcsolatot eredményezhet. Előtte érdemes az adatbázis konfigurációját módosítani.
Példa konfiguráció:
environment: POSTGRES_CONN_MAX_AGE: 3600
Lásd még
- POSTGRES_DISABLE_SERVER_SIDE_CURSORS¶
Added in version 4.9.1.
Letiltja az adatbázison belüli szerveroldali kurzorokat. Erre bizonyos pgbouncer konfigurációk esetén szükség lehet.
Példa konfiguráció:
environment: POSTGRES_DISABLE_SERVER_SIDE_CURSORS: 1
- WEBLATE_DATABASES¶
Added in version 5.1.
Set to false to disable environment based configuration of the database connection. Use Beállítások felülírása a adat kötetből to configure the database connection manually.
Adatbázis-mentési beállítások¶
- WEBLATE_DATABASE_BACKUP¶
A napi adatbázis-mentés beállítása a
DATABASE_BACKUPsegítségével. Alapértelmezett érték:plain.
Datastore server setup¶
Using Valkey or Redis is required by the Weblate container and you have to provide a connection parameters when running Weblate in Docker.
Lásd még
- REDIS_HOST¶
The datastore server hostname or IP address. Defaults to
cache.
- REDIS_PORT¶
The datastore server port. Defaults to
6379.
- REDIS_DB¶
The datastore database number, defaults to
1.
- REDIS_USER¶
Added in version 5.13: The datastore database user, not used by default.
- REDIS_PASSWORD¶
The datastore server password, not used by default.
- REDIS_TLS¶
Enables using SSL for the datastore connection.
- REDIS_VERIFY_SSL¶
Can be used to disable SSL certificate verification for the datastore connection.
E-mail szerver beállítása¶
A kimenő e-mailek működéséhez e-mail szerver szükséges.
Példa TLS-konfigurációra:
environment:
WEBLATE_EMAIL_HOST: smtp.example.com
WEBLATE_EMAIL_HOST_USER: user
WEBLATE_EMAIL_HOST_PASSWORD: pass
Példa SSL-konfigurációra:
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
Lásd még
- WEBLATE_EMAIL_HOST¶
A levelezőszerver hosztneve vagy IP-címe.
- WEBLATE_EMAIL_PORT¶
Levelezőszerver portja. Alapértelmezés: 25.
Lásd még
- WEBLATE_EMAIL_HOST_USER¶
E-mail hitelesítési felhasználónév.
Lásd még
- WEBLATE_EMAIL_HOST_PASSWORD¶
E-mail hitelesítési jelszó.
- WEBLATE_EMAIL_USE_SSL¶
Megadja, hogy implicit TLS (biztonságos) kapcsolatot használjon-e az SMTP szerverrel. Az ilyen TLS-kapcsolatot a legtöbb dokumentáció SSL néven említi, jellemzően a 465-ös porton működik. Ha problémát tapasztal, próbálja meg az explicit TLS beállítást:
WEBLATE_EMAIL_USE_TLS.A 4.11 verzióban változott: Az SSL/TLS támogatás automatikusan engedélyezésre kerül a
WEBLATE_EMAIL_PORTalapján.
- WEBLATE_EMAIL_USE_TLS¶
Meghatározza, hogy TLS (biztonságos) kapcsolatot használjon-e az SMTP szerverrel. Ez az explicit TLS-kapcsolatokra vonatkozik, jellemzően a 587-es vagy 25-ös porton. Ha a kapcsolat elakad, nézze meg az implicit TLS beállítást:
WEBLATE_EMAIL_USE_SSL.A 4.11 verzióban változott: Az SSL/TLS támogatás automatikusan engedélyezésre kerül a
WEBLATE_EMAIL_PORTalapján.
- WEBLATE_EMAIL_BACKEND¶
A Django háttérrendszer konfigurálása e-mailek küldéséhez.
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¶
Meghatározza, hogy a Weblate frissítse-e a tárolókat, és milyen módon.
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.Lásd még
AUTO_UPDATEfor details on how updates are scheduled throughout the day.Megjegyzés
Ez logikai értékű beállítás (használja a
"true"vagy"false"értékeket).
Webhely-integráció¶
- WEBLATE_GET_HELP_URL¶
A
GET_HELP_URLbeállítása.
- WEBLATE_STATUS_URL¶
A
STATUS_URLbeállítása.
- WEBLATE_PRIVACY_URL¶
A
PRIVACY_URLbeállítása.
- WEBLATE_PASSWORD_RESET_URL¶
Configures
PASSWORD_RESET_URL.
Hibajelentések gyűjtése és teljesítmény monitorozása¶
Javasolt a telepítés során fellépő hibák rendszerszintű gyűjtése, lásd: Hibajelentések gyűjtése és teljesítmény monitorozása.
A Rollbar támogatás engedélyezéséhez állítsa be a következőket:
- ROLLBAR_KEY¶
A Rollbar hozzáférési tokenje a jelentések küldéséhez.
- ROLLBAR_ENVIRONMENT¶
A Rollbar környezete. Alapértelmezés:
production.
A Sentry támogatás engedélyezéséhez állítsa be a következőket:
- SENTRY_DSN¶
A Sentry DSN címe. Lásd:
SENTRY_DSN.
- SENTRY_ENVIRONMENT¶
A Sentry környezet (opcionális). Alapértelmezés:
WEBLATE_SITE_DOMAIN.
- SENTRY_MONITOR_BEAT_TASKS¶
Whether to monitor Celery Beat tasks with Sentry, defaults to
True.
- SENTRY_TRACES_SAMPLE_RATE¶
A
SENTRY_TRACES_SAMPLE_RATEbeállítása.Példa:
environment: SENTRY_TRACES_SAMPLE_RATE: 0.5
- SENTRY_PROFILES_SAMPLE_RATE¶
A
SENTRY_PROFILES_SAMPLE_RATEbeállítása.Példa:
environment: SENTRY_PROFILES_SAMPLE_RATE: 0.5
- SENTRY_SEND_PII¶
A
SENTRY_SEND_PIIbeállítása.
To enable support for Google Cloud Error Reporting, set following:
- GOOGLE_CLOUD_ERROR_REPORTING_ENABLED¶
Enables
GOOGLE_CLOUD_ERROR_REPORTING, defaults toFalse.
- GOOGLE_CLOUD_ERROR_REPORTING_PROJECT¶
Google Cloud project to report errors to. If omitted, the Google client uses application default credentials to detect the project.
- GOOGLE_CLOUD_ERROR_REPORTING_SERVICE¶
Service name to use in Google Cloud Error Reporting, defaults to
weblate.
To enable support for OpenTelemetry tracing, set following:
- OPENTELEMETRY_ENABLED¶
Enables
OPENTELEMETRY_ENABLED, defaults toFalse.
- OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT¶
Configures
OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT.Példa:
environment: OPENTELEMETRY_ENABLED: true OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT: https://collector.example.com/v1/traces OPENTELEMETRY_TRACES_SAMPLE_RATE: 0.1
- OPENTELEMETRY_EXPORTER_OTLP_HEADERS¶
Configures
OPENTELEMETRY_EXPORTER_OTLP_HEADERSas a comma-separatedname:valuemapping.
- OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES¶
Configures
OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTESas a comma-separatedname:valuemapping.
- OPENTELEMETRY_SERVICE_NAME¶
Configures
OPENTELEMETRY_SERVICE_NAME.
- OPENTELEMETRY_TRACES_SAMPLE_RATE¶
Configures
OPENTELEMETRY_TRACES_SAMPLE_RATE.
Lokalizációs CDN¶
- WEBLATE_LOCALIZE_CDN_URL¶
- WEBLATE_LOCALIZE_CDN_PATH¶
Added in version 4.2.1.
Configuration for CDN add-ons, including JavaScript lokalizációs CDN and Translation files CDN.
A
WEBLATE_LOCALIZE_CDN_PATHa konténeren belüli elérési útvonal. Tartós tárhelyen tárolandó, nem ideiglenes helyen.Egy lehetséges megoldás, ha a Weblate adatkönyvtárába helyezi:
environment: WEBLATE_LOCALIZE_CDN_URL: https://cdn.example.com/ WEBLATE_LOCALIZE_CDN_PATH: /app/data/l10n-cdn
Megjegyzés
You are responsible for setting up serving of the files generated by Weblate, it only stores the files in configured location. See Lokalizációs CDN for secure serving guidance.
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¶
Added in version 5.6.1.
- WEBLATE_REMOVE_MACHINERY¶
Added in version 5.6.1.
Példa:
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
Konténerbeállítások¶
- WEBLATE_WORKERS¶
Added in version 4.6.1.
A konténerben futó alapértelmezett munkafolyamatok száma. Ha nincs megadva, induláskor automatikusan a CPU-magok számához igazodik.
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¶
Added in version 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¶
Added in version 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
- 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.Alapértelmezés szerint a párhuzamos folyamatok száma a
WEBLATE_WORKERSértékén alapul.Példa:
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¶
Added in version 5.7.1.
Elavult a(z) 2026.9.1 verzió óta.
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.Lásd még
- WEBLATE_ASGI¶
Added in version 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
- WEB_WORKERS¶
Configure how many web application workers should be executed.
It defaults to half of
WEBLATE_WORKERS, but is always at least 2.Példa:
environment: WEB_WORKERS: 4
A 5.13 verzióban változott:
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.Példa:
environment: WEB_WORKERS: 2 WEB_BLOCKING_THREADS: 8
- WEBLATE_SERVICE¶
Meghatározza, mely szolgáltatások fussanak a konténeren belül. Használja a Vízszintes skálázás konfigurálására.
A következő szolgáltatások érhetők el:
celery-beatCelery feladatütemező – egyszerre csak egy példány futhat. Ez végzi az adatbázis-struktúra migrációját is, így ezt kell elsőként elindítani.
celery-backupCelery munkafolyamat biztonsági mentésekhez – szintén csak egy példány engedélyezett.
celery-combinedCombined Celery worker for all task queues.
celery-celeryÁltalános Celery munkafolyamat.
celery-memoryFordítási memória Celery munkafolyamat.
celery-notifyÉrtesítések Celery munkafolyamat.
celery-singleSingle-process Celery worker for all task queues.
celery-translateAutomatikus fordítás Celery munkafolyamat.
webWebszerver.
Lásd még
- WEBLATE_ANUBIS_URL¶
Added in version 5.11.4.
Az Anubis szerver URL-címe, amely a kérések hitelesítését végzi. Ez hasznos lehet bejövő HTTP-kérések szűrésére proof-of-work (számítási feladaton alapuló igazolás) segítségével AI-robotok megállítására. A funkcióhoz be kell állítani az Anubis for Subrequest Authentication szolgáltatást.
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.
Docker-konténer kötetek¶
There are two volumes (data and cache) exported by the Weblate
container.
Megjegyzés
The other service containers (such as PostgreSQL or Valkey) have their data volumes as well and are required to maintain Weblate persistence.
The PostgreSQL container stores the database in the
/var/lib/postgresql volume and Valkey in the /data volume.
Valkey container does not save the data by default and needs additional
configuration to enable persistence.
Base your configuration on Weblate-provided examples or consult their documentation for more information.
A data kötet /app/data néven kerül csatolásra, és tartós adatok – például klónozott tárolók – vagy a Weblate testreszabásának tárolására szolgál. A DATA_DIR részletesen ismerteti a tartalmát.
The data volume is also place to store Weblate customization such as
Beállítások felülírása a adat kötetből, Logó és egyéb statikus fájlok cseréje or
Customizing code.
A Docker-kötet elhelyezkedése a hoszt rendszeren a Docker konfigurációjától függ, de jellemzően a következő helyen található: /var/lib/docker/volumes/weblate-docker_weblate-data/_data/ (az útvonal a docker-compose könyvtár, a konténer és a kötet nevét tartalmazza).
The cache volume is mounted as /app/cache and is used to store static
files and CACHE_DIR. Its content is recreated on container startup
and the volume can be mounted using ephemeral filesystem such as tmpfs, but
the mount has to allow execution because Weblate stores generated helper files
there.
When mounting /app/cache explicitly as tmpfs in Docker Compose,
enable execution:
tmpfs:
- /app/cache:exec
When also setting ownership options, keep the exec option:
tmpfs:
- /app/cache:exec,uid=1000,gid=1000
Kézi létrehozás esetén a könyvtárak tulajdonosának UID 1000-nek kell lennie, mivel a konténeren belül ez a felhasználó kerül használatra.
A Weblate-konténer futtatható írásvédett gyökérfájlrendszerrel is. Ebben az esetben két további tmpfs kötetet kell csatolni: /tmp és /run.
Írásvédett gyökérfájlrendszer¶
Added in version 4.18.
Ha a konténer írásvédett gyökérfájlrendszerrel fut, két további tmpfs kötet szükséges: /tmp és /run.
Konfiguráció a környezeti változókon túl¶
A Docker környezeti változók célja, hogy elérhetővé tegyék a Weblate telepítések szempontjából releváns konfigurációs beállítások többségét.
Ha olyan beállítást talál, amely nincs kitéve környezeti változóként, és úgy gondolja, hogy annak kellene lennie, nyugodtan kérje annak kitételét a Weblate egy jövőbeli verziójában.
Ha olyan beállítást kell módosítania, amely nincs kitéve Docker környezeti változóként, azt még mindig megteheti, akár az adatkötetből, akár a Docker image kiterjesztésével.
Lásd még
Beállítások felülírása a adat kötetből¶
Létrehozhat egy fájlt a /app/data/settings-override.py helyen, azaz az adatkötet gyökerében, hogy kiterjessze vagy felülírja a környezeti változókon keresztül definiált beállításokat.
Beállítások testreszabása a Docker-kép kiterjesztésével¶
A beállításokat az adat kötet helyett a Docker-kép szintjén is testreszabhatjuk:
Adjon hozzá egy modult a csomagjához, amely importálja az összes beállítást a
weblate.settings_dockermodulból.Például a Python modul létrehozása részben meghatározott példa csomagstruktúrán belül létrehozhat egy fájlt a
weblate_customization/weblate_customization/settings.pyhelyen a következő kezdeti kóddal:from weblate.settings_docker import *
Hozzon létre egy egyéni
Dockerfilefájlt, amely a hivatalos Weblate Docker-képre épül, majd telepíti a saját csomagját, és aDJANGO_SETTINGS_MODULEkörnyezeti változót az Ön beállítási moduljára állítja: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
A hivatalos Weblate Docker-kép használata helyett építsen egy egyéni képet ebből a
Dockerfilefájlból.There is no clean way to do this with
docker-compose.override.yml. You could addbuild: .to theweblatenode in that file, but then your custom image will be tagged asweblate/weblatein your system, which could be problematic.So, instead of using the
docker-compose.ymlstraight from the official repository, unmodified, and extending it throughdocker-compose.override.yml, you may want to make a copy of the officialdocker-compose.ymlfile, and edit your copy to replaceimage: weblate/weblatewithbuild: ..További részletekért lásd a build hivatkozás a Compose fájlban, amely ismerteti, hogyan lehet képfájlt forrásból építeni
docker-composehasználatával.Bővítse saját egyedi beállítási modulját további beállítások megadásával vagy meglévők újradefiniálásával.
A beállításokat az importálási utasítás előtt vagy után is megadhatja, attól függően, hogy mely beállítások élvezzenek elsőbbséget. Az import utasítás előtti beállításokat a környezeti változók és az adatkötetben megadott felülírások módosíthatják. Az import utáni beállításokat azonban már nem lehet felülírni.
Továbblépve akár újraalkothatja a
weblate.docker_settingsegyes működési elemeit is, ahogyan azt a következő linken láthatja: a fájl tartalma, például beállítások környezeti változóként való elérhetővé tételét vagy a beállítások Python fájlokon keresztüli felülírását az adatkötetből.
Logó és egyéb statikus fájlok cseréje¶
A Weblate-hez tartozó statikus fájlokat le lehet cserélni azáltal, hogy a következő könyvtárba helyezi őket: /app/data/python/customize/static (lásd: Docker-konténer kötetek). Például a /app/data/python/customize/static/favicon.ico fájl létrehozása lecseréli a favicon-t.
Tipp
Ezek a fájlok a konténer indulásakor kerülnek átmásolásra a megfelelő helyre, tehát minden módosítás után szükséges a Weblate újraindítása.
This approach can be also used to override Weblate templates. For example, custom Jogi modul documents and styles can be provided as described in Customizing legal documents and styles.
Alternatívaként saját modult is létrehozhat (lásd: A Weblate testreszabása), amelyet külön kötetként csatolhat a Docker-konténerhez, például így:
weblate:
volumes:
- weblate-data:/app/data
- ./weblate_customization/weblate_customization:/app/data/python/weblate_customization
environment:
WEBLATE_ADD_APPS: weblate_customization
Customizing code¶
Megjegyzés
The internal Weblate API may vary significantly between releases and is not meant to be stable. Please review your custom code interacting with Weblate internals on each upgrade.
You can place additional Python code into /app/data/python/customize
(see Docker-konténer kötetek). It is already installed as a Django application
inside Weblate (this is used for customizing templates and static files as
described above).
This can be used to place any code (for example Egyedi ellenőrzések írása) or to add custom maintenance tasks to the Celery task scheduler.
/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¶
The Weblate Docker setup can be extended with additional containers to provide complementary services such as machine translation, spell checking, or other tools that enhance the translation workflow. These services can be integrated into your Docker Compose configuration and work alongside Weblate.
When adding third-party containers, consider the following:
Network connectivity: Ensure containers can communicate with each other by placing them on the same Docker network
Data persistence: Use volumes for services that need to persist data
Security: Configure appropriate access controls and avoid exposing unnecessary ports
LibreTranslate Docker container integration¶
LibreTranslate is a free and open-source machine translation service that can be self-hosted. Integrating it with Weblate provides offline machine translation capabilities without relying on external services.
You can incorporate the LibreTranslate service into your Weblate deployment by including it in a docker-compose.override.yml file. Since it runs within the Docker network, it’s only accessible to Weblate and not exposed to the public internet.
Basic setup using 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:
For GPU-accelerated translation (if you have NVIDIA GPU available):
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:
After starting the services with docker compose down && docker compose up -d,
configure LibreTranslate in Weblate:
Access the Weblate admin interface
Navigate to Manage → Translation services
Add a new LibreTranslate service with:
- Szolgáltatás:
LibreTranslate
- API URL-cím:
http://libretranslate:5000- API-kulcs:
Leave empty
LibreTranslate is now configured and available for machine translation in Weblate.
Megjegyzés
The LibreTranslate service runs without the web UI (
--disable-web-ui) and is only accessible via the API within the Docker network.Models are automatically updated when the container starts. (
LT_UPDATE_MODELS: true)Data is persisted using Docker volumes for optimal performance and data safety.
Health checks ensure that the Docker engine properly observes the state of the service.
For GPU acceleration, use the CUDA image variant and ensure your system has NVIDIA Docker support. This container runs as a privileged user to be able to use the GPU.
No external ports are exposed, making the setup secure by default.
Anubis Docker container integration¶
Anubis is a web AI firewall utility to block AI scrapers and other disruptive traffic on the server. It is typically needed for publicly open Weblate installations to avoid excessive load caused by scraping.
Anubis can be deployed using 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:
Megjegyzés
The anubis-data volume in the above configuration is expected to contain
botPolicies.yaml with a bot policy configured to your needs.
At minimum, you need to adjust status codes as described in https://anubis.techaro.lol/docs/admin/configuration/subrequest-auth.
It is also recommended to configure persistent storage backend as described in https://anubis.techaro.lol/docs/admin/policies/#storage-backends.
Ezután a Weblate-ben engedélyezheti az Anubis használatát ezzel:
environment:
WEBLATE_ANUBIS_URL: http://anubis:8923
Lásd még
PostgreSQL szerver konfigurálása¶
A PostgreSQL-konténer alapértelmezett konfigurációt használ, amely nem használja ki hatékonyan az elérhető CPU-magokat vagy a memóriát. A teljesítmény javítása érdekében javasolt a konfiguráció testreszabása.
A konfiguráció a Database Configuration (Adatbázis-konfiguráció) szakaszban leírtak szerint módosítható: https://hub.docker.com/_/postgres. A környezetéhez illeszkedő beállítások automatikusan generálhatók a következő eszköz segítségével: https://pgtune.leopard.in.ua/.
Konténer belső működése¶
A konténer a supervisor programot használja az egyes szolgáltatások indítására. Vízszintes skálázás esetén egy konténer csak egyetlen szolgáltatást indít el.
A szolgáltatások állapotának ellenőrzéséhez használja a következőt:
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
Háttérfeladatok Celery használatával 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