Suiteáil ag baint úsáide as Docker¶

Le himscaradh Weblate atá bunaithe ar dhocairí, is féidir leat do chás pearsanta Weblate a chur ar bun agus ag feidhmiú i gceann soicindí. Tá gach spleáchas de chuid Weblate san áireamh cheana féin. Tá PostgreSQL socraithe mar an mbunachar sonraí réamhshocraithe agus Valkey mar chúltaca taisceála.

Riachtanais crua-earraí¶

Ba cheart go n-oibreodh Weblate ar aon chrua-earraí comhaimseartha gan fadhbanna, seo a leanas an chumraíocht íosta a theastaíonn chun Weblate a rith ar óstach amháin (Weblate, bunachar sonraí agus freastalaí gréasáin):

3 GB RAM
2 chroílár LAP
1 GB de spás stórála

Note

Bíonn éagsúlacht mhór ag baint le riachtanais iarbhír do shuiteáil Weblate bunaithe ar mhéid na n-aistriúchán a bhainistítear ann.

Úsáid cuimhne¶

An níos mó cuimhne is amhlaidh is fearr - úsáidtear é le haghaidh taisceadh ar gach leibhéal (córas comhaid, bunachar sonraí agus Weblate). Maidir leis na céadta comhpháirteanna aistriúcháin, moltar 4 GB RAM ar a laghad.

Hint

Maidir le córais a bhfuil níos lú cuimhne acu ná mar a mholtar, moltar Socrú Soilire aonphróisis.

Úsáid LAP¶

Méadaíonn go leor úsáideoirí comhthráthacha an méid croíleacáin LAP atá ag teastáil.

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.

Úsáid stórála¶

Is é an gnáthúsáid stórála bunachar sonraí ná thart ar 300 MB in aghaidh an 1 milliún focal óstaithe.

Ní hionann an spás stórála a theastaíonn le haghaidh stórtha clónáilte, ach déanann Weblate iarracht a méid a choinneáil íosta trí chlóin éadomhain a dhéanamh.

Feidhmíocht stórála¶

Déanann oibríochtaí rialaithe leaganacha go leor cuardaigh meiteashonraí córas comhad. Dá bhrí sin, ní mór don fho-eolaire vcs i DATA_DIR moill íseal léitheoireachta a bheith aige; is féidir le stóráil le rochtain mall ar mheiteashonraí oibríochtaí ar nós git status a thógáil i bhfad fiú nuair a bhíonn a tháirgeacht mórchóir maith. Coinnigh CACHE_DIR ar stóráil áitiúil nó sealadach íseal-mhoill nuair is féidir.

Déanann na seiceálacha imscartha moill chuardaigh meiteashonraí a thomhas don dá shuíomh agus tugann siad rabhadh nuair a sháraíonn an mhoill mheánach 10 milleasoicind. Is tomhas garbh pointe in am é seo a mbíonn tionchar ag an gcóras comhad agus ualach an chórais air. Athrith weblate check --deploy sula n-athraítear an chumraíocht stórála.

Nóid¶

Maidir le suíomhanna beaga agus meánmhéide (na milliúin focal óstáilte), is féidir gach comhpháirteanna Weblate (féach Forbhreathnú ar ailtireacht) a reáchtáil ar nód amháin.

Nuair a fhásann tú go dtí na céadta milliún focal óstaithe, moltar nód tiomnaithe a bheith agat don bhunachar sonraí (féach Socrú bunachar sonraí le haghaidh Weblate).

Suiteáil¶

Hint

Glactar leis sna samplaí seo a leanas go bhfuil timpeallacht oibre Ducker agat, le docker-compose-plugin suiteáilte. Seiceáil le do thoil doiciméadú an Docker le haghaidh treoracha.

Cruthaíonn sé seo freastalaí imscaradh Weblate trí HTTP, mar sin ba chóir duit é a chur taobh thiar de seachfhreastalaí foirceanta HTTPS. Is féidir leat imscaradh freisin le seachfhreastalaí HTTPS, féach Deimhnithe SSL uathoibríoch ag baint úsáide as Let's Encrypt. Le haghaidh socruithe níos mó, féach le do thoil Scálú go cothrománach.

Clón an repo weblate-docker:
```
git clone https://github.com/WeblateOrg/docker-compose.git weblate-docker
cd weblate-docker
```
Note

Is samplaí de chumraíochtaí imscartha iad comhaid Docker Compose. De ghnáth, déanann oibreoirí iad a shaincheapadh dá n-imscaradh féin agus coinníonn siad na hathruithe áitiúla sin. Seachadtar nuashonruithe feidhmchláir Weblate trí chlibeanna íomhá Docker; níl aon chonair nuashonraithe atá ceangailte le heisiúint ann do chomhaid Compose saincheaptha.

Cruthaigh a:file: comhad docker-compose.override.yml le do shocruithe. Féach Athróga timpeallachta docker le haghaidh liosta iomlán d'athróga comhshaoil.

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

Note

Mura bhfuil WEBLATE_ADMIN_PASSWORD socraithe, cruthaítear an t-úsáideoir riaracháin le pasfhocal randamach a thaispeántar ar an gcéad tosaithe.

Déanann an sampla a chuirtear ar fáil éisteacht le Weblate ar chalafort 80, déanann mapáil an chalafoirt a chur in eagar sa chomhad docker-compose.override.yml chun é a athrú.

Tosaigh coimeádáin Ghréasáin:
```
docker compose up
```

Bain sult as d'imscaradh Weblate, tá sé inrochtana ar phort 80 den choimeádán weblate.

See also

Orduithe bainistíochta a agairt

Roghnú clárlann íomhá Docker¶

Foilsítear coimeádáin ghréasán chuig na clárlanna seo a leanas:

Docker Hub, féach https://hub.docker.com/r/weblate/weblate
Clárlann Pacáistí GitHub, féach https://github.com/WeblateOrg/docker/pkgs/container/weblate

Note

Gabhann gach sampla íomhánna ó Docker Hub faoi láthair, le do thoil coigeartaigh an chumraíocht dá réir chun clárlann eile a úsáid.

Ag roghnú chlib íomhá Docker¶

Roghnaigh clib a mheaitseálann do thimpeallacht agus d’ionchais:

Ainm chlib	Cur síos	Bain úsáid as cás
`latest`	An scaoileadh cobhsaí Weblate, meaitseálann an scaoileadh clibeáilte is déanaí	Nuashonruithe rollta i dtimpeallacht táirgthe
`<YEAR>`	Scaoileadh cobhsaí Weblate	Nuashonruithe rollta laistigh de bhliain féilire i dtimpeallacht táirgthe
`<YEAR>.<MONTH>`	Scaoileadh cobhsaí Weblate	Nuashonruithe rollta laistigh de scaoileadh míosúil i dtimpeallacht léiriúcháin
`<YEAR>.<MONTH>.<PATCH>.<BUILD>`	Scaoileadh cobhsaí Weblate	Imscaradh dea-shainithe i dtimpeallacht táirgthe
`edge`	Scaoileadh cobhsaí Weblate le hathruithe forbartha sa choimeádán Docker (mar shampla spleáchais nuashonraithe)	Nuashonruithe rollta i dtimpeallacht stáitse
`edge-<DATE>-<SHA>`	Scaoileadh cobhsaí Weblate le hathruithe forbartha sa choimeádán Docker (mar shampla spleáchais nuashonraithe)	Imscaradh dea-shainithe i dtimpeallacht stáitse
`bleeding`	Leagan forbartha Weblate ó Git	Nuashonruithe rollta chun gnéithe atá le teacht de Weblate a thástáil
`bleeding-<DATE>-<SHA>`	Leagan forbartha Weblate ó Git	Imscaradh dea-shainithe chun gnéithe Weblate atá le teacht a thástáil

Déanann ár CI gach íomhá a thástáil sula bhfoilsítear í, mar sin ba cheart go mbeadh an leagan bleeding sách sábháilte le húsáid.

Is féidir liosta iomlán de na clibeanna foilsithe a fháil ag Pacáistí GitHub

Coimeádán docker le tacaíocht HTTPS¶

Féach Suiteáil le haghaidh treoracha úsáide cineálacha, ní luann an chuid seo ach na difríochtaí i gcomparáid leis.

Seachfhreastalaí críochnúcháin SSL¶

Is féidir SSL a fhoirceannadh lasmuigh de choimeádán Weblate. Chun go n-oibreoidh sé seo go maith le chéile, ní mór roinnt ceanntásca a chur chuig an gcoimeádán ionas go mbeidh sé ar an eolas faoina thimpeallacht iarbhír. Déantar cur síos níos mine ar na ceanntásca seo i Rith taobh thiar seachfhreastalaí droim ar ais.

Cumraíocht seachfhreastalaí droim ar ais nginx samplach le haghaidh coimeádán 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;
}

Timpeallacht coimeádáin Docker le haghaidh foirceannadh seachtrach SSL.¶

WEBLATE_ENABLE_HTTPS=1
WEBLATE_IP_PROXY_HEADER=HTTP_X_FORWARDED_FOR
WEBLATE_TRUSTED_PROXY_ADDRESSES=192.0.2.10

Cuir seoladh nó líonra an seachfhreastalaí droim ar ais mar a fheiceann coimeádán Weblate é in ionad an tseolta seachfhreastalaí iontaofa samplach. Cinntigh nach féidir le cliaint neamhiontaofa teacht ar phort coimeádáin foilsithe tríd an seachfhreastalaí droim ar ais a sheachbhóthar.

Ag baint úsáide as deimhnithe SSL féin¶

Sa chás go bhfuil deimhniú SSL féin agat is mian leat a úsáid, ní gá ach na comhaid a chur isteach i toirt sonraí Weblate (féach Toirteanna coimeádán docker):

ssl/fullchain.pem ina bhfuil an teastas lena n-áirítear aon deimhnithe CA atá ag teastáil
ssl/privkey.pem ina bhfuil an eochair phríobháideach

Caithfidh an dá chomhad seo a bheith ina n-úinéirí ag an úsáideoir céanna leis an gceann a thosaíonn an coimeádán docker agus masc comhaid a bheith socraithe go 600 (inléite agus inscríofa ag an úsáideoir úinéireacht amháin).

Ina theannta sin, glacfaidh coimeádán Weblate le naisc SSL ar phort 4443, beidh tú ag iarraidh cur ar aghaidh an chalafoirt le haghaidh HTTPS a chur san áireamh i sárú cumadóireachta docker:

version: '3'
services:
  weblate:
    ports:
      - 80:8080
      - 443:4443

Más rud é go bhfuil suíomhanna eile á n-óstáil agat ar an bhfreastalaí céanna cheana féin, is dócha go n-úsáideann seachfhreastalaí droim ar ais, amhail NGINX, calafoirt 80 agus 443. Chun an nasc HTTPS ó NGINX a chur ar aghaidh chuig an gcoimeádán docker, is féidir leat an chumraíocht seo a leanas a úsáid:

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

Cuir luachanna iarbhír ó do thimpeallacht in ionad <SITE_URL>, <SITE> agus <EXPOSED_DOCKER_PORT>.

Deimhnithe SSL uathoibríoch ag baint úsáide as Let's Encrypt¶

Ar eagla go dteastaíonn uait Let's Encrypt deimhnithe SSL a ghintear go huathoibríoch ar shuiteáil phoiblí a úsáid, ní mór duit seachfhreastalaí HTTPS droim ar ais a chur le coimeádán Docker breise, úsáidfear https-portal chuige sin. Baintear úsáid as seo sa chomhad docker-compose-https.yml. Ansin cruthaigh comhad docker-compose-https.override.yml le do shocruithe:

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'

Nuair a dhéanann tú agairt ar docker compose ní mór duit an dá chomhad a chur ar aghaidh chuige, agus ansin déan:

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

An coimeádán Docker a uasghrádú¶

De ghnáth is smaoineamh maith é an coimeádán Weblate a nuashonrú agus an coimeádán PostgreSQL a choinneáil ag an leagan atá agat, toisc go bhfuil uasghrádú PostgreSQL pianmhar go leor agus i bhformhór na gcásanna ní thugann sé go leor buntáistí.

Is féidir leat é seo a dhéanamh trí cloí leis an docker-compose atá ann cheana féin agus gan ach na híomhánna is déanaí a tharraingt agus ansin atosú:

# 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

Ba cheart bunachar sonraí Weblate a aistriú go huathoibríoch ar an gcéad tosaithe, agus níor cheart go mbeadh gá le gníomhartha láimhe breise.

Note

Ní thacaítear le huasghráduithe díreacha ach amháin le haghaidh eisiúintí ón mbliain féilire reatha nó ón mbliain féilire roimhe sin. Más gá duit uasghrádú ó eisiúint níos sine, uasghrádaigh ar dtús go leagan idirmheánach atá liostaithe i Treoracha leagan ar leith.

Má úsáideann tú na comhaid Compose samplacha gan athruithe áitiúla, is féidir leat athbhreithniú a dhéanamh ar nuashonruithe sa stórlann docker-compose freisin, cé nach bhfuil gá leis seo don chuid is mó de na huasghráduithe Weblate. Ní mór comhaid Compose saincheaptha a choinneáil mar chuid de d’imscaradh. Féach Coimeádán PostgreSQL a uasghrádú le haghaidh uasghrádú ar an bhfreastalaí PostgreSQL.

Coimeádán PostgreSQL a uasghrádú¶

Note

D'athraigh PostgreSQL 18 an t-eolaire sonraí réamhshocraithe taobh istigh den choimeádán. Bhí socrú coitianta níos sine ag suiteáil an toirt bunachar sonraí ag /var/lib/postgresql/data, ach úsáideann PostgreSQL 18 /var/lib/postgresql de réir réamhshocraithe anois.

Más rud é go bhfuil tú ag uasghrádú ó leagan níos sine, déan an sprioc gléasta i do chumraíocht Docker a nuashonrú go dtí an cosán nua, nó coinnigh an seansprioc gléasta agus socraigh PGDATA dá réir.

Má fhágtar an seansprioc gléasta gan athrú gan PGDATA a shocrú, d’fhéadfadh sé go scríobhfadh PostgreSQL a chuid sonraí lasmuigh den toirt bhuan.

Féach doiciméadacht PGDATA le haghaidh tuilleadh eolais.

Ní thacaíonn coimeádáin PostgreSQL le huasghrádú uathoibríoch idir leagan, ní mór duit an t-uasghrádú a dhéanamh de láimh. Léiríonn na céimeanna seo a leanas ceann de na roghanna uasghrádaithe.

Stop coimeádán Weblate:
```
docker compose stop weblate cache
```

Cúltaca an bunachar sonraí:

docker compose exec database pg_dumpall --clean --if-exists --username weblate > backup.sql

Stop an coimeádán bunachar sonraí:
```
docker compose stop database
```
Bain an t-imleabhar PostgreSQL:
```
docker compose rm -v database
docker volume remove weblate-docker_postgres-data
```
Hint

Tá ainm an tionscadail Docker Compose in ainm an imleabhair, is é sin an t-ainm eolaire de réir réamhshocraithe cad is weblate-docker sa doiciméadú seo.
Coigeartaigh docker-compose.yml chun leagan nua PostgreSQL a úsáid.
Tosaigh coimeádán an bhunachair shonraí:
```
docker compose up -d database
```
Athchóirigh an bunachar sonraí ón gcúltaca:
```
cat backup.sql | docker compose exec -T database psql --username weblate --dbname weblate
```
Hint

Cinntigh go dtagann ainm an bhunachair shonraí le POSTGRES_DB.
(Roghnach) Nuashonraigh pasfhocal don úsáideoir Weblate. Seans go mbeidh sé seo ag teastáil nuair a athraítear aistriú go PostgreSQL 14 nó 15 mar bhealach chun pasfhocail a stóráil:
```
docker compose exec -T database psql --username weblate --dbname weblate -c "ALTER USER weblate WITH PASSWORD 'weblate'"
```
Hint

Cinntigh go dtagann ainm an bhunachair shonraí le POSTGRES_DB.
Tosaigh gach coimeádán atá fágtha:
```
docker compose up -d
```

Sínigh isteach admin¶

Tar éis duit an coimeádán a shocrú, is féidir leat síniú isteach mar úsáideoir admin le pasfhocal curtha ar fáil in WEBLATE_ADMIN_PASSWORD, nó pasfhocal randamach a ghintear ar an gcéad tosú mura bhfuil sé sin socraithe.

Chun pasfhocal admin a athshocrú, atosaigh an coimeádán le WEBLATE_ADMIN_PASSWORD socraithe go pasfhocal nua.

See also

WEBLATE_ADMIN_PASSWORD
WEBLATE_ADMIN_NAME
WEBLATE_ADMIN_EMAIL

Líon na bpróiseas agus tomhaltas cuimhne¶

Cinntear líon na bpróiseas oibrithe don fheidhmchlár gréasáin agus do Celery araon go huathoibríoch bunaithe ar líon na LAPanna. Oibríonn sé seo go maith do fhormhór na meaisíní fíorúla scamall mar is gnách go mbíonn líon beag LAPanna agus méid maith cuimhne acu seo.

De réir réamhshocraithe, láimhseálann próiseas oibrí Celery comhcheangailte amháin gach scuaine tascanna trí úsáid a bhaint as linn 'prefork' a bhfuil líon próiseas ann atá trí oiread luach WEBLATE_WORKERS. Laghdaítear an úsáid chuimhne trí chuimhne tosaigh an fheidhmchláir a roinnt i measc na n-oibrithe Celery go léir, agus méadaítear tréchur na dtascanna a bhuí leis an líon próiseas níos airde.

Sa chás go bhfuil go leor croíleacáin LAP agat agus go bhfuil fadhbanna cuimhne agat, déan iarracht líon na n-oibrithe a laghdú:

environment:
  WEBLATE_WORKERS: 2

Is féidir leat an t-oibrí comhcheangailte a mhionchoigeartú:

environment:
  CELERY_COMBINED_OPTIONS: --concurrency 12 --prefetch-multiplier 1

Mar mhalairt air sin, bain úsáid as an mód scoilte chun catagóirí aonair oibrithe a rith agus a mhionchoigeartú:

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

Rialaíonn an t-iolraitheoir réamhghabhála cé mhéad tasc is féidir le gach sliotán forghníomhaithe oibrí a chur in áirithe. Seachnaíonn an réamhshocrú de cheann tascanna breise fada nó tascanna troma ualaigh a chur in áirithe. Úsáideann an t-oibrí fógra ceithre cinn sa sampla seo toisc gur féidir le maolánú a chuid tascanna gearra leas a bhaint as. Ní mhéadaigh an luach ach amháin tar éis moill scuaine agus úsáid chuimhne oibrí a thomhas.

Is féidir úsáid na cuimhne a laghdú tuilleadh trí Celery a rith i bpróiseas aonair:

environment:
  CELERY_WORKER_MODE: single

See also

WEBLATE_WORKERS
CELERY_WORKER_MODE
CELERY_COMBINED_OPTIONS
CELERY_MAIN_OPTIONS
CELERY_NOTIFY_OPTIONS
CELERY_MEMORY_OPTIONS
CELERY_TRANSLATE_OPTIONS
CELERY_BACKUP_OPTIONS
CELERY_BEAT_OPTIONS
CELERY_SINGLE_OPTIONS
WEBLATE_ASGI
WEB_WORKERS
WEB_BLOCKING_THREADS

Scálú go cothrománach¶

Added in version 4.6.

Is féidir leat iolracha coimeádáin Weblate a reáchtáil chun an tseirbhís a scáileáil Caithfidh gach coimeádán an toirte:file: /app/data a roinnt, moltar córas comhaid braisle mar GlusterFS a úsáid chuige seo. Ba chóir go mbeadh an toirte /app/cache ar leithligh do gach coimeádán.

Tá ról sainithe ag gach coimeádán Weblate ag baint úsáide as WEBLATE_SERVICE athróg timpeallachta. Lean go cúramach leis an gcáipéisíocht le do thoil mar ba chóir go mbeadh cuid de na seirbhísí ar siúl uair amháin sa chnuasach, agus tá tábhacht le hord na seirbhísí freisin.

Is féidir leat socrú samplaí a fháil sa docker-compose repo mar docker-compose-split.yml.

Rabhaidh maidir le cumraíocht tosaithe¶

Taifeadann coimeádán Docker rabhaidh chumraíochta a dteastaíonn gníomh ina leith — rabhaidh a thagann chun cinn le linn an tosaithe — sa toirt chomhroinnte /app/data. Taispeántar iad leis an ordú weblate check --deploy agus sa chomhéadan bainistíochta Tuarascáil feidhmíochta, chomh maith le bheith á scríobh i loga an choimeádáin.

Tuairiscíonn gach coimeádán a rabhaidh ar leithligh. Coinníonn sé seo rabhaidh ó choimeádáin a bhfuil róil éagsúla WEBLATE_SERVICE acu le feiceáil in imscaradh cothrománach. Athnuachantar tuarascálacha agus a gcoimeádán ag rith agus baintear iad le linn múchadh ordúil coimeádáin. Rachaidh tuarascálacha a fhágtar de bharr múchadh tobann in éag tar éis cúig nóiméad, agus glantar comhaid tuarascála atá seanchaite go huathoibríoch trí thosaithe coimeádáin níos déanaí.

Athróga timpeallachta docker¶

Is féidir go leor de Cumraíocht Weblate a shocrú sa choimeádán Docker trí úsáid a bhaint as na hathróga timpeallachta a gcuirtear síos orthu thíos.

Más gá duit socrú a shainiú nach bhfuil nochta trí athróga timpeallachta Docker, féach Cumraíocht thar athróga timpeallachta.

Rúin a rith¶

Added in version 5.0.

Tacaíonn coimeádán Weblate le rúin a sheoladh mar chomhaid. Chun é sin a úsáid, cuir an iarmhír _FILE leis an athróg timpeallachta agus seol an comhad rúnda trí Docker.

Seans go mbeidh cuma ar docker-compose.yml gaolmhar:

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

See also

Conas rúin a úsáid in Docker Compose

Socruithe cineálacha¶

WEBLATE_DEBUG¶

Cumraíonn sé mód dífhabhtaithe Django ag baint úsáide as DEBUG.

Sampla:

environment:
  WEBLATE_DEBUG: 1

See also

Díchumasaigh mód dífhabhtaithe

WEBLATE_LOGLEVEL¶

Cumraíonn sé briathrachas na logála. Socraigh é seo go DEBUG chun logaí níos mionsonraithe a fháil.

Réamhshocruithe le INFO nuair a mhúchtar WEBLATE_DEBUG, úsáidtear DEBUG nuair a chuirtear mód dífhabhtaithe ar siúl.

Chun logáil níos ciúine a dhéanamh, bain úsáid as EARRÁID nó RABHADH.

WEBLATE_LOGLEVEL_DATABASE¶: Cumraíonn sé logáil na bhfiosruithe bunachar sonraí ar bhriathrachas.

WEBLATE_LOG_GELF_HOST¶: Added in version 5.9.

Cumraíonn sé cianlogáil trí nasc GELF TCP a úsáid. Is féidir é a úsáid chun comhtháthú le Graylog.

WEBLATE_LOG_GELF_PORT¶: Added in version 5.9.

Úsáid port saincheaptha le haghaidh WEBLATE_LOG_GELF_HOST, réamhshocraithe go 12201.

WEBLATE_SITE_TITLE¶: Athraítear teideal an tsuímh a thaispeántar i gceanntásc gach leathanaigh.

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.

Sampla:

environment:
  WEBLATE_SITE_DOMAIN: example.com:8080

See also

WEBLATE_ADMIN_NAME¶

WEBLATE_ADMIN_EMAIL¶

Cumraíonn sé ainm agus r-phost riaracháin an láithreáin. Úsáidtear é chun an bheirt ADMINS agus úsáideoir admin a chruthú (féach WEBLATE_ADMIN_PASSWORD le haghaidh tuilleadh eolais faoi sin).

Sampla:

environment:
  WEBLATE_ADMIN_NAME: Weblate admin
  WEBLATE_ADMIN_EMAIL: noreply@example.com

See also

WEBLATE_ADMIN_PASSWORD¶

Socraíonn sé an pasfhocal don úsáideoir admin.

Mura bhfuil sé socraithe agus níl an t-úsáideoir admin ann, cruthaítear é le pasfhocal randamach a thaispeántar ar an gcéad tosaithe coimeádán.
Mura bhfuil sé socraithe agus má tá úsáideoir admin ann, ní dhéanfar aon ghníomh.
Má tá an t-úsáideoir admin coigeartaithe ar gach tosaithe coimeádán chun WEBLATE_ADMIN_PASSWORD, WEBLATE_ADMIN_NAME agus WEBLATE_ADMIN_EMAIL a mheaitseáil.

Warning

D'fhéadfadh sé a bheith ina riosca slándála pasfhocal a stóráil sa chomhad cumraíochta. Smaoinigh ar an athróg seo a úsáid le haghaidh socrú tosaigh amháin (nó lig do Weblate pasfhocal randamach a ghiniúint ar an am tosaithe tosaigh) nó chun pasfhocal a ghnóthú.

See also

Sínigh isteach admin
Rúin a rith
WEBLATE_ADMIN_PASSWORD
WEBLATE_ADMIN_NAME
WEBLATE_ADMIN_EMAIL

WEBLATE_ADMIN_NOTIFY_ERROR¶

Cibé acu ríomhphost a sheoladh chuig riarthóirí má tharlaíonn earráid freastalaí. Cumasaithe de réir réamhshocraithe.

Seans gur mhaith leat úsáid a bhaint as bailiúchán earráidí eile ar nós Sentry nó Barra Rolla agus é seo a mhúchadh.

See also

WEBLATE_SERVER_EMAIL¶

An seoladh ríomhphoist óna seoltar teachtaireachtaí earráide.

See also

WEBLATE_DEFAULT_FROM_EMAIL¶

Cumraíonn sé an seoladh le haghaidh ríomhphoist amach.

See also

WEBLATE_ADMINS_CONTACT¶: Cumraíonn ADMINS_CONTACT.

WEBLATE_CONTACT_FORM¶: Cumraíonn sé iompraíocht na foirme teagmhála, féach CONTACT_FORM.

WEBLATE_ALLOWED_HOSTS¶

Cumraíonn óstainmneacha HTTP ceadaithe ag baint úsáide as ALLOWED_HOSTS.

Réamhshocraithe go * a cheadaíonn gach ainm óstach.

Sampla:

environment:
  WEBLATE_ALLOWED_HOSTS: weblate.example.com,example.com

See also

WEBLATE_REGISTRATION_OPEN¶

Cumraigh cé acu an bhfuil clárúcháin oscailte trí scoránú REGISTRATION_OPEN.

Sampla:

environment:
  WEBLATE_REGISTRATION_OPEN: 0

WEBLATE_REGISTRATION_CAPTCHA¶

Added in version 5.10.

Cumraigh cé acu an n-úsáidtear captcha le haghaidh clárúcháin agus gníomhartha neamhfhíordheimhnithe eile, féach REGISTRATION_CAPTCHA.

Sampla:

environment:
  WEBLATE_REGISTRATION_CAPTCHA: 0

WEBLATE_REGISTRATION_ALLOW_BACKENDS¶

Cumraigh cé na modhanna fíordheimhnithe is féidir a úsáid chun cuntas nua a chruthú trí REGISTRATION_ALLOW_BACKENDS.

Sampla:

environment:
  WEBLATE_REGISTRATION_OPEN: 0
  WEBLATE_REGISTRATION_ALLOW_BACKENDS: azuread-oauth2,azuread-tenant-oauth2

WEBLATE_REGISTRATION_REBIND¶: Added in version 4.16.

Cumraíonn REGISTRATION_REBIND.

WEBLATE_REGISTRATION_ALLOW_DISPOSABLE_EMAILS¶

Added in version 5.16.1.

Cumraíonn REGISTRATION_ALLOW_DISPOSABLE_EMAILS.

Sampla:

environment:
  WEBLATE_REGISTRATION_ALLOW_DISPOSABLE_EMAILS: 1

WEBLATE_PROJECT_WEB_RESTRICT_PRIVATE¶

Added in version 5.17.

Cumraíonn PROJECT_WEB_RESTRICT_PRIVATE.

Réamhshocraithe go cumasaithe.

WEBLATE_PROJECT_WEB_RESTRICT_ALLOWLIST¶

Added in version 5.17.

Cumraíonn PROJECT_WEB_RESTRICT_ALLOWLIST.

Ag súil le liosta de shlugaí tionscadail iontaofa atá scartha le camóga.

WEBLATE_WEBHOOK_RESTRICT_PRIVATE¶

Added in version 5.17.

Cumraíonn WEBHOOK_RESTRICT_PRIVATE.

Réamhshocraithe go cumasaithe.

WEBLATE_WEBHOOK_PRIVATE_ALLOWLIST¶

Added in version 5.17.

Cumraíonn WEBHOOK_PRIVATE_ALLOWLIST.

Ag súil le liosta d'ainmneacha óstach nó fearainn iontaofa atá scartha le camóga.

WEBLATE_ALLOWED_ASSET_SIZE¶: Added in version 2025.7.

Cumraíonn ALLOWED_ASSET_SIZE.

WEBLATE_ASSET_RESTRICT_PRIVATE¶

Added in version 2025.5.

Cumraíonn ASSET_RESTRICT_PRIVATE.

Réamhshocraithe go cumasaithe.

WEBLATE_ASSET_PRIVATE_ALLOWLIST¶

Added in version 2025.5.

Cumraíonn ASSET_PRIVATE_ALLOWLIST.

Ag súil le liosta d'ainmneacha óstach nó fearainn iontaofa atá scartha le camóga.

WEBLATE_TIME_ZONE¶

Cumraíonn sé an crios ama in úsáid i Weblate, féach TIME_ZONE.

Note

Chun crios ama an choimeádáin Docker féin a athrú, úsáid an athróg timpeallachta TZ.

Sampla:

environment:
  WEBLATE_TIME_ZONE: Europe/Prague

WEBLATE_ENABLE_HTTPS¶

Glacann Weblate leis go n-oibrítear é taobh thiar de sheachvótálaí HTTPS droim ar ais, úsáideann Weblate HTTPS i ríomhphoist agus naisc API nó socraíonn sé bratacha slána ar fhianáin.

Hint

Féach le do thoil ENABLE_HTTPS doiciméadú le haghaidh caveats féideartha.

Note

Ní fhágann sé seo go nglacann coimeádán Weblate le naisc HTTPS, ní mór duit é sin a chumrú freisin, féach Coimeádán docker le tacaíocht HTTPS le haghaidh samplaí.

Sampla:

environment:
  WEBLATE_ENABLE_HTTPS: 1

See also

WEBLATE_NGINX_IPV6¶

Added in version 5.17.

Rialaíonn sé an n-éisteann an NGINX pacáilte le seoltaí IPv6.

Is iad seo a leanas na luachanna a dtacaítear leo:

auto chun éisteoirí IPv6 a chumasú ach amháin nuair a bhíonn IPv6 ar fáil i rith-am an choimeádáin. Seo an réamhshocrú.
ar chun éisteoirí IPv6 a chumasú i gcónaí.
as chun éisteoirí IPv6 a dhíchumasú.

Sampla:

environment:
  WEBLATE_NGINX_IPV6: auto

WEBLATE_IP_PROXY_HEADER¶

Faigh Weblate an seoladh IP ó aon cheanntásc HTTP tugtha. Úsáid é seo agus seachfhreastalaí droim ar ais os comhair an choimeádáin Weblate.

Cumasaítear IP_BEHIND_REVERSE_PROXY agus socraítear IP_PROXY_HEADER.

Nuair a shocraítear é go HTTP_X_FORWARDED_FOR, réitíonn an nginx cuachta seoladh an chliaint ag baint úsáide as WEBLATE_TRUSTED_PROXY_ADDRESSES, úsáideann sé an seoladh sin ina logaí, agus seolann sé seoladh normalaithe amháin chuig Weblate.

Changed in version 2026.9: Ní chuireann an nginx pacáilte muinín i X-Forwarded-For ó gach seoladh líonra a thuilleadh. Caithfear seoltaí seachfhreastalaí iontaofa a chumrú go sainráite.

Note

Caithfidh an fhormáid cloí le hionchais Django. Athraíonn Django transforms ainmneacha ceanntásca HTTP amh mar seo a leanas:

athraíonn gach carachtar go cás uachtair
cuirtear béim ar bhunsraitheanna in ionad aon phunann
réamhfhorlíonann HTTP_ réimír

Mar sin dhéanfaí X-Forwarded-For a mhapáil go HTTP_X_FORWARDED_FOR.

Sampla:

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.

Cumraíonn sé seo seoltaí, líonraí nó ainmneacha óstacha IPv4 nó IPv6 na seachfhreastalaithe droim ar ais a bhfuil muinín ag an nginx pacáilte iontu chun X-Forwarded-For a sholáthar. Deighil luachanna iolracha le spás bán.

Ní úsáidtear an socrú seo ach amháin nuair a bhíonn WEBLATE_IP_PROXY_HEADER ina HTTP_X_FORWARDED_FOR. Má tá an liosta folamh, úsáideann nginx an piara TCP láithreach ina logaí agus seolann sé an seoladh sin ar aghaidh chuig Weblate.

Ná liostaigh ach na seachfhreastalaithe atá faoi do smacht, agus ná nochtaigh coimeádán Weblate trí chonair a sheachnaíonn iad.

Sampla:

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.

Cumraíonn IP_PROXY_OFFSET.

Nuair a bhíonn WEBLATE_IP_PROXY_HEADER cothrom le HTTP_X_FORWARDED_FOR, seolann an nginx cuachta seoladh normalaithe amháin ar aghaidh agus úsáideann an coimeádán fritháireamh éifeachtach de 0.

WEBLATE_USE_X_FORWARDED_PORT¶: Added in version 5.0.1.

Boole a shonraíonn cé acu ar cheart an ceanntásc X-Forwarded-Port a úsáid in ionad an athróg SERVER_PORT META. Níor cheart é seo a chumasú ach amháin má tá seachfhreastalaí a shocraíonn an ceanntásc seo in úsáid.

See also

USE_X_FORWARDED_PORT

Note

Is socrú boolean é seo (bain úsáid as "fíor" nó "bréag").

WEBLATE_SECURE_PROXY_SSL_HEADER¶

Tá tuple a léiríonn teaglaim ceanntásc/luach HTTP a léiríonn iarratas slán. Tá sé seo ag teastáil nuair a bhíonn Weblate ag rith taobh thiar de sheachfhreastalaí droim ar ais a dhéanann foirceannadh SSL nach dtéann thar cheanntásca caighdeánacha HTTPS.

Sampla:

environment:
  WEBLATE_SECURE_PROXY_SSL_HEADER: HTTP_X_FORWARDED_PROTO,https

See also

WEBLATE_REQUIRE_LOGIN¶

Cumasaítear REQUIRE_LOGIN chun fíordheimhniú a chur i bhfeidhm ar an Gréasán iomlán.

Sampla:

environment:
  WEBLATE_REQUIRE_LOGIN: 1

WEBLATE_LEGAL_INTEGRATION¶

Cumasaíonn sé an modúl Modúl dlí in imscaradh Docker. De réir réamhshocraithe, tá an comhtháthú díchumasaithe; fág an athróg seo gan socrú nó fág folamh í chun í a dhíchumasú.

Is iad seo a leanas na luachanna a dtacaítear leo:

tos-confirm chun an modúl dlíthiúil a chumasú agus dearbhú doiciméad dlíthiúil a fhorfheidhmiú le linn fíordheimhniú sóisialta agus d'úsáideoirí atá sínithe isteach.
wllegal chun an comhtháthú céanna a chumasú agus na teimpléid doiciméad dlíthiúil óstáilte ó wllegal a luchtú ina theannta sin. Úsáideann seirbhísí atá á n-oibriú ag Weblate s.r.o. na teimpléid seo agus níl siad beartaithe le haghaidh úsáide ginearálta.

Chun do dhoiciméid dhlíthiúla féin a sholáthar i Docker, sáraigh na teimpléid i /app/data/python/customize/templates/legal/documents, féach Lógó agus comhaid statacha eile a athsholáthar.

Athchruthaigh an coimeádán Docker tar éis an athróg timpeallachta seo a athrú, mar shampla ag baint úsáide as docker compose up -d. Ní chuireann atosú coimeádáin atá ann cheana luachanna timpeallachta athraithe i bhfeidhm.

Sampla:

environment:
  WEBLATE_LEGAL_INTEGRATION: tos-confirm

See also

Modúl dlí
Lógó agus comhaid statacha eile a athsholáthar

WEBLATE_LEGAL_DOCUMENT_CSS_CLASS¶

Cumraíonn sé LEGAL_DOCUMENT_CSS_CLASS in imscaradh Docker le WEBLATE_LEGAL_INTEGRATION cumasaithe.

Socraigh é seo don rang atá mar sprioc ag do bhileog stíle dlí saincheaptha. Socraigh é mar theaghrán folamh chun doiciméid dlí a rindreáil gan rang fillteáin.

Sampla:

environment:
  WEBLATE_LEGAL_DOCUMENT_CSS_CLASS: ""

WEBLATE_LEGAL_HIDDEN_DOCUMENTS¶

Cumraíonn sé LEGAL_HIDDEN_DOCUMENTS in imscaradh Docker le WEBLATE_LEGAL_INTEGRATION cumasaithe.

Cuir liosta d’aitheantóirí leathanaigh doiciméad dlíthiúil ar fáil, scartha le camóga.

Úsáidtear doiciméid dhlíthiúla seachtracha mar chúltaca do leathanaigh inmheánacha i bhfolach. Nascann an chumraíocht seo a leanas an dá dhoiciméad go seachtrach agus teastaíonn comhaontú amháin a chlúdaíonn na téarmaí seirbhíse agus an polasaí príobháideachta:

Sampla:

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¶: Cumasaíonn sé PUBLIC_ENGAGE.

WEBLATE_GOOGLE_ANALYTICS_ID¶: Cumraítear aitheantas do Google Analytics trí GOOGLE_ANALYTICS_ID a athrú.

WEBLATE_DEFAULT_PULL_MESSAGE¶: Cumraíonn sé an teideal agus an teachtaireacht réamhshocraithe le haghaidh iarratais tarraingthe trí API trí DEFAULT_PULL_MESSAGE a athrú.

See also

DEFAULT_PULL_MESSAGE

WEBLATE_SIMPLIFY_LANGUAGES¶: Cumraíonn sé an polasaí simplithe teanga, féach SIMPLIFY_LANGUAGES.

WEBLATE_HIDE_SHARED_GLOSSARY_COMPONENTS¶: Folaíonn sé comhpháirteanna an ghlórais nuair a roinntear iad le tionscadail eile, féach HIDE_SHARED_GLOSSARY_COMPONENTS.

WEBLATE_DEFAULT_ACCESS_CONTROL¶: Cumraíonn sé an réamhshocrú Rialú rochtana do thionscadail nua, féach DEFAULT_ACCESS_CONTROL.

WEBLATE_DEFAULT_TRANSLATION_REVIEW¶: Added in version 5.16.

Cumraíonn sé an luach réamhshocraithe do Cumasaigh léirmheasanna, múchta de réir réamhshocraithe.

WEBLATE_DEFAULT_SOURCE_REVIEW¶: Added in version 5.16.

Cumraíonn sé an luach réamhshocraithe le haghaidh Cumasaigh léirmheasanna foinse, múchta de réir réamhshocraithe.

WEBLATE_DEFAULT_RESTRICTED_COMPONENT¶: Cumraíonn sé an luach réamhshocraithe do Rochtain shrianta le haghaidh comhpháirteanna nua, féach DEFAULT_RESTRICTED_COMPONENT.

WEBLATE_DEFAULT_TRANSLATION_PROPAGATION¶: Cumraíonn sé an luach réamhshocraithe le haghaidh Ceadaigh iomadú aistriúcháin do chomhpháirteanna nua, féach DEFAULT_TRANSLATION_PROPAGATION.

WEBLATE_DEFAULT_COMMITER_EMAIL¶: Cumraíonn DEFAULT_COMMITER_EMAIL.

WEBLATE_DEFAULT_COMMITER_NAME¶: Cumraíonn DEFAULT_COMMITER_NAME.

WEBLATE_DEFAULT_SHARED_TM¶: Cumraíonn DEFAULT_SHARED_TM.

WEBLATE_DEFAULT_AUTOCLEAN_TM¶: Cumraíonn DEFAULT_AUTOCLEAN_TM.

WEBLATE_COMMIT_PENDING_HOURS¶: Cumraíonn sé an luach réamhshocraithe le haghaidh Aois na n-athruithe le gealltanas le haghaidh comhpháirteanna nua, féach COMMIT_PENDING_HOURS.

WEBLATE_GPG_IDENTITY¶: Cumraítear síniú GPG na ngealltanas, féach WEBLATE_GPG_IDENTITY.

See also

Tiomnaíonn síniú Git le GnuPG

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¶: Cumraíonn sé réimír URL do chomhaid statach a sheirbheáiltear ó CACHE_DIR.

WEBLATE_SILENCED_SYSTEM_CHECKS¶: Cumraigh seiceálacha nach mian leat go dtaispeánfaí iad, féach 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¶

Is féidir an ceanntásc HTTP Content-Security-Policy a shaincheapadh.

See also

WEBLATE_LICENSE_FILTER¶: Cumraíonn LICENSE_FILTER.

WEBLATE_LICENSE_REQUIRED¶: Cumraíonn LICENSE_REQUIRED.

WEBLATE_WEBSITE_REQUIRED¶: Cumraíonn WEBSITE_REQUIRED.

WEBLATE_VERSION_DISPLAY¶: Cumraíonn VERSION_DISPLAY.

WEBLATE_HIDE_VERSION¶: Cumraítear HIDE_VERSION.

WEBLATE_BASIC_LANGUAGES¶: Cumraíonn BASIC_LANGUAGES.

WEBLATE_DEFAULT_AUTO_WATCH¶: Cumraíonn DEFAULT_AUTO_WATCH.

WEBLATE_RATELIMIT_ATTEMPTS¶

WEBLATE_RATELIMIT_LOCKOUT¶

WEBLATE_RATELIMIT_WINDOW¶

Added in version 4.6.

Cumraigh teorannóir rátaí.

Hint

Is féidir leat cumraíocht a shocrú d'aon scóipí teoranta rátaí. Chun sin a dhéanamh cuir réimír WEBLATE_ le haon cheann de na suíomhanna a thuairiscítear in Teorainn rátaí.

See also

WEBLATE_API_RATELIMIT_ANON¶

WEBLATE_API_RATELIMIT_USER¶: Added in version 4.11.

Cumraíonn sé API_RATELIMIT_ANON agus API_RATELIMIT_USER. Is iad na réamhshocruithe ná 100/lá d’úsáideoirí gan ainm agus 5000/uair d’úsáideoirí fíordheimhnithe.

See also

Teorainn ráta API

WEBLATE_API_RATELIMIT_USER_OVERRIDES¶

WEBLATE_API_RATELIMIT_IP_OVERRIDES¶

Added in version 2026.10.

Mapálacha JSON a chumraíonn API_RATELIMIT_USER_OVERRIDES agus API_RATELIMIT_IP_OVERRIDES. Is réad folamh an luach réamhshocraithe don dá cheann acu. Bain úsáid as null i JSON chun úsáideoir, seoladh IP nó líonra a dhíolmhú ó shrianta ráta an API.

Mar shampla, i 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"}'

Tá tús áite ag rialacha maidir le hainmneacha úsáideora thar rialacha IP. Féach Teorainn ráta API le haghaidh sonraí faoin gcaoi a ndéantar comhaireamh agus faoi na ceanglais maidir le cumraíocht seachfhreastalaí.

WEBLATE_ENABLE_HOOKS¶: Added in version 4.13.

Cumraíonn ENABLE_HOOKS.

WEBLATE_ENABLE_AVATARS¶: Added in version 4.6.1.

Cumraíonn sé ENABLE_AVATARS.

WEBLATE_AVATAR_URL_PREFIX¶: Added in version 4.15.

Cumraíonn AVATAR_URL_PREFIX.

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.

Cumraíonn LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH.

WEBLATE_SSH_EXTRA_ARGS¶: Added in version 4.9.

Cumraíonn SSH_EXTRA_ARGS.

WEBLATE_BORG_EXTRA_ARGS¶

Added in version 4.9.

Cumraíonn BORG_EXTRA_ARGS mar liosta de args scartha camóg.

Sampla:

environment:
  WEBLATE_BORG_EXTRA_ARGS: --exclude,vcs/

WEBLATE_ENABLE_SHARING¶: Added in version 4.14.1.

Cumraíonn ENABLE_SHARING.

WEBLATE_SUPPORT_STATUS_CHECK¶: Added in version 5.5.

Cumraíonn SUPPORT_STATUS_CHECK.

WEBLATE_EXTRA_HTML_HEAD¶: Added in version 4.15.

Cumraíonn sé EXTRA_HTML_HEAD.

WEBLATE_INTERNAL_BOT_EMAIL_TEMPLATE¶: Added in version 2026.7.1.

Cumraíonn INTERNAL_BOT_EMAIL_TEMPLATE.

WEBLATE_PRIVATE_COMMIT_EMAIL_TEMPLATE¶: Added in version 4.15.

Cumraíonn PRIVATE_COMMIT_EMAIL_TEMPLATE.

WEBLATE_PRIVATE_COMMIT_EMAIL_OPT_IN¶: Added in version 4.15.

Cumraíonn PRIVATE_COMMIT_EMAIL_OPT_IN.

WEBLATE_PRIVATE_COMMIT_NAME_TEMPLATE¶: Added in version 5.16.

Cumraíonn PRIVATE_COMMIT_NAME_TEMPLATE.

WEBLATE_PRIVATE_COMMIT_NAME_OPT_IN¶

Added in version 5.16.

Cumraíonn PRIVATE_COMMIT_NAME_OPT_IN.

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"
      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 -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¶: Added in version 4.17.

Cumraíonn UNUSED_ALERT_DAYS.

WEBLATE_REPORT_EXPIRY¶: Added in version 2026.8.

Cumraíonn REPORT_EXPIRY.

WEBLATE_UPDATE_LANGUAGES¶: Added in version 4.3.2.

Cumraíonn UPDATE_LANGUAGES.

WEBLATE_VCS_ALLOW_HOSTS¶: Added in version 5.15.

Cumraíonn VCS_ALLOW_HOSTS.

WEBLATE_VCS_PRIVATE_ALLOWLIST¶: Added in version 2026.9.

Cumraíonn VCS_PRIVATE_ALLOWLIST.

WEBLATE_VCS_ALLOW_SCHEMES¶

Added in version 5.15.

Cumraíonn VCS_ALLOW_SCHEMES.

The file scheme is disabled for security reasons. Including it prevents Weblate from starting.

WEBLATE_VCS_RESTRICT_PRIVATE¶: Added in version 5.17.

Cumraíonn VCS_RESTRICT_PRIVATE.

WEBLATE_VCS_CLONE_DEPTH¶: Added in version 5.4.

Cumraíonn VCS_CLONE_DEPTH.

WEBLATE_VCS_API_DELAY¶: Added in version 5.4.

Cumraíonn VCS_API_DELAY.

WEBLATE_VCS_API_TIMEOUT¶: Added in version 5.15.

Cumraíonn VCS_API_TIMEOUT.

WEBLATE_CORS_ALLOWED_ORIGINS¶

Added in version 4.16.

Ceadaigh iarratais CORS chuig API ó bhunús ar leith.

Sampla:

environment:
  WEBLATE_CORS_ALLOWED_ORIGINS: https://example.com,https://weblate.org

WEBLATE_CORS_ALLOW_ALL_ORIGINS¶: Added in version 5.6.1: Ceadaíonn sé iarratais CORS chuig API ó gach bunús.

WEBLATE_WEBSITE_ALERTS_ENABLED¶: Added in version 5.17.

Cumraíonn 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, or g suffix. The suffix is case-insensitive, and 0 disables the request body size limit.

environment:
    CLIENT_MAX_BODY_SIZE: 200m

Hint

Tá réimír WEBLATE_ in easnamh ar an athróg seo d'aon ghnó mar go bhfuil sé roinnte le coimeádán tríú páirtí a úsáidtear i Deimhnithe SSL uathoibríoch ag baint úsáide as Let's Encrypt.

WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE¶

Cumraíonn TRANSLATION_UPLOAD_MAX_SIZE.

Tá an luach i mbéiteanna.

WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE¶

Cumraíonn COMPONENT_ZIP_UPLOAD_MAX_SIZE.

Tá an luach i mbéiteanna.

WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE¶

Cumraíonn PROJECT_BACKUP_UPLOAD_MAX_SIZE.

Tá an luach i mbéiteanna. Cinntigh go bhfuil CLIENT_MAX_BODY_SIZE mór go leor freisin le haghaidh comhaid chúltaca uaslódáilte.

WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS¶: Added in version 2026.5.

Cumraíonn PROJECT_BACKUP_IMPORT_MAX_MEMBERS.

WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE¶

Added in version 2026.5.

Cumraíonn PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE.

Tá an luach i mbéiteanna.

WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE¶

Added in version 2026.5.

Cumraíonn PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE.

Tá an luach i mbéiteanna.

WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE¶

Added in version 2026.5.

Cumraíonn PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE.

Tá an luach i mbéiteanna.

WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO¶: Added in version 2026.5.

Cumraíonn PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO.

Dintiúir shuíomhanna óstála cóid¶

Sa choimeádán Docker, is féidir dintiúir óstála an chóid a chumrú i n-athróga ar leithligh nó trí fhoclóir Python a úsáid chun iad a shocrú ag an am céanna. Is samplaí iad seo a leanas le haghaidh Iarratais tharraingt GitHub, ach baineann siad le gach Comhtháthú rialaithe leagan a bhfuil ainmneacha athróg athraithe mar is cuí orthu.

Important

Ní mór an réimír WEBLATE_ a bheith i ngach ainm athróg timpeallachta. Mar shampla, chun dintiúir GitHub a chumrú, bain úsáid as WEBLATE_GITHUB_USERNAME, ní GITHUB_USERNAME. Baineann sé seo le cibé an bhfuil tú ag cumrú le haghaidh iarratais tarraingthe nó aon chomhtháthú VCS eile.

D’fhéadfadh cumraíocht shamplach le haghaidh iarratais tarraingthe GitHub breathnú mar seo a leanas:

WEBLATE_GITHUB_USERNAME=api-user
WEBLATE_GITHUB_TOKEN=api-token
WEBLATE_GITHUB_HOST=api.github.com

Bainfear úsáid as mar:

GITHUB_CREDENTIALS = {
    "api.github.com": {
        "username": "api-user",
        "token": "api-token",
    }
}

Nó is féidir foclóir Python a sholáthar mar theaghrán:

WEBLATE_GITHUB_CREDENTIALS='{ "api.github.com": { "username": "api-user", "token": "api-token", } }'

Nó an cosán chuig comhad ina bhfuil an foclóir Python:

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¶: Cumraíonn sé Iarratais tharraingt GitHub trí GITHUB_CREDENTIALS a athrú.

See also

Cumrú dintiúir óstála cóid i Docker

WEBLATE_GITHUB_LEGACY_APP_WEBHOOK_SECRET¶: Added in version 2026.8.

Cumraíonn sé GITHUB_LEGACY_APP_WEBHOOK_SECRET. Is féidir an leagan _FILE a úsáid chun an rún a luchtú ó chomhad.

Stóráiltear Aipeanna GitHub atá cláraithe tríd an sreabhadh manifíl in-aipe sa bhunachar sonraí agus níl athróga comhshaoil ag teastáil uathu. Féach Fógraí GitHub.

WEBLATE_GITLAB_USERNAME¶

WEBLATE_GITLAB_TOKEN¶

WEBLATE_GITLAB_HOST¶

WEBLATE_GITLAB_CREDENTIALS¶: Cumraíonn sé Iarratais chumasc GitLab trí GITLAB_CREDENTIALS a athrú.

See also

Cumrú dintiúir óstála cóid i Docker

WEBLATE_GITEA_USERNAME¶

WEBLATE_GITEA_TOKEN¶

WEBLATE_GITEA_HOST¶

WEBLATE_GITEA_CREDENTIALS¶: Cumraíonn sé Iarratais tarraingt Gitea trí GITEA_CREDENTIALS a athrú.

See also

Cumrú dintiúir óstála cóid i Docker

WEBLATE_PAGURE_USERNAME¶

WEBLATE_PAGURE_TOKEN¶

WEBLATE_PAGURE_HOST¶

WEBLATE_PAGURE_CREDENTIALS¶: Cumraíonn sé leathanach iarratais chumaisc trí PAGURE_CREDENTIALS a athrú.

See also

Cumrú dintiúir óstála cóid i Docker

WEBLATE_BITBUCKETSERVER_USERNAME¶

WEBLATE_BITBUCKETSERVER_TOKEN¶

WEBLATE_BITBUCKETSERVER_HOST¶

WEBLATE_BITBUCKETSERVER_CREDENTIALS¶: Cumraíonn sé Iarratais ar tharraingt Ionad Sonraí Bitbucket trí BITBUCKETSERVER_CREDENTIALS a athrú.

WEBLATE_BITBUCKETCLOUD_USERNAME¶

WEBLATE_BITBUCKETCLOUD_WORKSPACE¶

WEBLATE_BITBUCKETCLOUD_TOKEN¶

WEBLATE_BITBUCKETCLOUD_HOST¶

WEBLATE_BITBUCKETCLOUD_CREDENTIALS¶: Cumraíonn sé Iarratais ar tharraingt Bitbucket Cloud trí BITBUCKETCLOUD_CREDENTIALS a athrú.

See also

Cumrú dintiúir óstála cóid i Docker

WEBLATE_AZURE_DEVOPS_USERNAME¶

WEBLATE_AZURE_DEVOPS_ORGANIZATION¶

WEBLATE_AZURE_DEVOPS_TOKEN¶

WEBLATE_AZURE_DEVOPS_HOST¶

WEBLATE_AZURE_DEVOPS_CREDENTIALS¶: Cumraíonn sé Iarratais tarraingthe Azure DevOps trí AZURE_DEVOPS_CREDENTIALS a athrú.

See also

Cumrú dintiúir óstála cóid i Docker

Socruithe moltaí uathoibríocha¶

Changed in version 4.13: Tá seirbhísí molta uathoibríocha cumraithe anois sa chomhéadan úsáideora, féach Moltaí uathoibríocha.

Allmhairítear na hathróga timpeallachta atá ann cheana le linn an aistrithe go Weblate 4.13, ach ní bheidh aon éifeacht bhreise ag baint lena n-athrú.

Socruithe fíordheimhnithe¶

Hint

Tá an fíordheimhniú bunaithe ar ríomhphost casta air mura bhfuil sé díchumasaithe ag 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¶

Cumraíocht fíordheimhnithe LDAP.

Sampla le haghaidh ceangal díreach:

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

Sampla le cuardach agus ceangal:

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

Sampla do chuardach agus ceangal ceardchumainn:

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

Sampla le cuardach agus ceangal le hEolaire Gníomhach:

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)

See also

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¶: Cumasaítear Fíordheimhniú GitHub.

Eagrán Fiontraíochta GitHub¶

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¶: Cumasaítear Fíordheimhniú GitHub EE.

Bitbuicéad¶

WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_KEY¶

WEBLATE_SOCIAL_AUTH_BITBUCKET_OAUTH2_SECRET¶: Cumasaítear Fíordheimhniú Bitbucket.

Facebook¶

WEBLATE_SOCIAL_AUTH_FACEBOOK_KEY¶

WEBLATE_SOCIAL_AUTH_FACEBOOK_SECRET¶: Cumasaítear 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¶: Cumasaítear Google OAuth 2.

GitLab¶

WEBLATE_SOCIAL_AUTH_GITLAB_KEY¶

WEBLATE_SOCIAL_AUTH_GITLAB_SECRET¶

WEBLATE_SOCIAL_AUTH_GITLAB_API_URL¶: Cumasaítear GitLab OAuth 2.

Gitea¶

WEBLATE_SOCIAL_AUTH_GITEA_API_URL¶

WEBLATE_SOCIAL_AUTH_GITEA_KEY¶

WEBLATE_SOCIAL_AUTH_GITEA_SECRET¶: Cumasaíonn sé fíordheimhniú Gitea.

Aitheantas Entra Microsoft¶

WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_KEY¶

WEBLATE_SOCIAL_AUTH_AZUREAD_OAUTH2_SECRET¶: Cumasaíonn sé fíordheimhniú Aitheantais Microsoft Entra, féach Aitheantas Entra Microsoft.

Aitheantas Microsoft Entra le tacaíocht do Thionóntaí¶

WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_KEY¶

WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_SECRET¶

WEBLATE_SOCIAL_AUTH_AZUREAD_TENANT_OAUTH2_TENANT_ID¶: Cumasaíonn sé fíordheimhniú Microsoft Entra ID le tacaíocht Tionónta, féach Aitheantas Entra Microsoft.

Eochrach¶

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¶: Cumasaíonn sé fíordheimhniú Slack, féach Keycloak - Open Source Red Hat SSO.

WEBLATE_SOCIAL_AUTH_KEYCLOAK_ID_KEY¶

Added in version 5.17.

Cumraíonn sé seo cé acu éileamh a úsáidtear mar aitheantóir úsáideora uathúil ó Keycloak. Is é ríomhphost an rogha réamhshocraithe.

Hint

Nuair a bhíonn Keycloak cumraithe chun IDP tríú páirtí a aibítiú, beidh ort WEBLATE_CSP_FORM_SRC a chumrú don fhearann IDP tríú páirtí.

Sampla nuair a bhíonn Keycloak ag cur fíordheimhnithe ar aghaidh chuig Microsoft.¶

environment:
  WEBLATE_CSP_FORM_SRC: login.microsoftonline.com

Díoltóirí linux¶

Is féidir leat fíordheimhniú a chumasú ag baint úsáide as seirbhísí fíordheimhnithe díoltóirí Linux trí athróga seo a leanas a shocrú d'aon luach.

WEBLATE_SOCIAL_AUTH_FEDORA¶

WEBLATE_SOCIAL_AUTH_OPENSUSE¶

WEBLATE_SOCIAL_AUTH_OPENINFRA¶

WEBLATE_SOCIAL_AUTH_UBUNTU¶

Leac¶

WEBLATE_SOCIAL_AUTH_SLACK_KEY¶

WEBLATE_SOCIAL_AUTH_SLACK_SECRET¶: Cumasaíonn sé fíordheimhniú Slack, féach Leac.

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¶: Cumraigh comhtháthú cineálach OpenID Connect.

See also

OIDC (OpenID Connect)

Ceangail OpenID Fedora¶

Added in version 5.15.

WEBLATE_SOCIAL_AUTH_FEDORA_OIDC_KEY¶

WEBLATE_SOCIAL_AUTH_FEDORA_OIDC_SECRET¶: Cumraíonn sé comhtháthú Fedora OpenID Connect.

See also

Fedora

SAML¶

Gintear eochracha SAML féin-shínithe go huathoibríoch ar an gcéad thos Sa chás gur mhaith leat eochracha féin a úsáid, cuir an deimhniú agus an eochair phríobháideach in /app/data/ssl/saml.crt agus /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¶: Socruithe Soláthraí Aitheantais SAML, féach Fíordheimhniú SAML.

WEBLATE_SAML_SECURITY_CONFIG¶

Added in version 2026.6.

Cumraíocht slándála SAML mar réad JSON, curtha chuig SOCIAL_AUTH_SAML_SECURITY_CONFIG. Mar shampla, chun an requestedAuthnContext a dhíchumasú (atá riachtanach do roinnt soláthraithe aitheantais amhail Microsoft Entra ID le fíordheimhniú ilfhachtóireach):

environment:
  WEBLATE_SAML_SECURITY_CONFIG: '{"requestedAuthnContext": false}'

See also

socruithe slándála python3-saml

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.

mapáil tréithe SAML.

Socruithe fíordheimhnithe eile¶

WEBLATE_NO_EMAIL_AUTH¶: Díchumasaítear fíordheimhniú ríomhphoist nuair a shocraítear é ar aon luach. Féach Fíordheimhniú pasfhocail a mhúchadh.

WEBLATE_MIN_PASSWORD_SCORE¶

Scór íosta pasfhocail mar a mheas an meastóir neart pasfhocal zxcvbn. Tá an réamhshocrú ar 3, socraigh é go 0 chun an seiceáil neart a dhíchumasú.

See also

Socrú bunachar sonraí PostgreSQL¶

Cruthaíonn docker-compose.yml an bunachar sonraí, mar sin bíonn tionchar ag na socruithe seo ar choimeádáin Weblate agus PostgreSQL araon.

POSTGRES_PASSWORD¶: Pasfhocal PostgreSQL.

See also

Rúin a rith

POSTGRES_USER¶: Ainm úsáideora PostgreSQL.

POSTGRES_DB¶: Ainm bunachar sonraí PostgreSQL.

POSTGRES_HOST¶: Óstainm freastalaí PostgreSQL nó seoladh IP. Réamhshocrú ar bunachar sonraí.

POSTGRES_PORT¶: Port freastalaí PostgreSQL. Réamhshocruithe go ceann ar bith (úsáideann sé an luach réamhshocraithe).

POSTGRES_SSL_MODE¶: Cumraigh conas a láimhseálann PostgreSQL SSL i dtaca leis an bhfreastalaí, le haghaidh roghanna féideartha féach Tuairisc Mhód SSL.

POSTGRES_ALTER_ROLE¶

Cumraítear ainm ról PostgreSQL le hathrú le linn ascnaimh an bhunachair sonraí, féach Weblate a chumrú chun PostgreSQL a úsáid.

Réamhshocruithe chuig POSTGRES_USER.

POSTGRES_CONN_MAX_AGE¶

Added in version 4.8.1.

Fad saoil nasc bunachar sonraí, mar shlánuimhir soicind. Úsáid 0 chun naisc bhunachar sonraí a dhúnadh ag deireadh gach iarratais.

Changed in version 5.1: Is é an t-iompar réamhshocraithe ná naisc bhunachar sonraí neamhtheoranta marthanacha a bheith agat.

De ghnáth, beidh nasc níos oscailte leis an mbunachar sonraí mar thoradh ar mharthanacht naisc a chumasú. Coigeartaigh cumraíocht do bhunachar sonraí roimh chumasú.

Cumraíocht shamplach:

environment:
    POSTGRES_CONN_MAX_AGE: 3600

See also

POSTGRES_DISABLE_SERVER_SIDE_CURSORS¶

Added in version 4.9.1.

Díchumasaigh cúrsóirí taobh an fhreastalaí sa bhunachar sonraí. Tá sé seo riachtanach i roinnt socruithe pgbouncer.

Cumraíocht shamplach:

environment:
    POSTGRES_DISABLE_SERVER_SIDE_CURSORS: 1

See also

WEBLATE_DATABASES¶: Added in version 5.1.

Socraigh go bréagach chun cumraíocht atá bunaithe ar an timpeallacht den nasc bunachar sonraí a dhíchumasú. Úsáid Socruithe sáraitheacha ón méid sonraí chun an nasc bunachar sonraí a chumrú de láimh.

Socruithe cúltaca bunachar sonraí¶

See also

Sonraí dumpáilte le haghaidh cúltacaí

WEBLATE_DATABASE_BACKUP¶: Cumraíonn sé dumpáil laethúil an bhunachair shonraí trí úsáid a bhaint as DATABASE_BACKUP. Réamhshocrú go plain.

Socrú freastalaí stórais sonraí¶

Éilíonn coimeádán Weblate úsáid Valkey nó Redis agus caithfidh tú paraiméadair nasc a sholáthar agus Weblate á rith i Docker.

See also

Cumraigh an taisce

REDIS_HOST¶: Ainm óstach nó seoladh IP an fhreastalaí stórais sonraí. Is é taisce an rogha réamhshocraithe.

REDIS_PORT¶: Port an fhreastalaí stórais sonraí. Is é 6379 an réamhshocrú.

REDIS_DB¶: Is é 1 an réamhshocrú a dhéanann uimhir bhunachar sonraí an stórais sonraí.

REDIS_USER¶: Added in version 5.13: Úsáideoir bunachar sonraí an stórais datastorage, nach n-úsáidtear de réir réamhshocraithe.

REDIS_PASSWORD¶: Pasfhocal an fhreastalaí stórais sonraí, nach n-úsáidtear de réir réamhshocraithe.

See also

Rúin a rith

REDIS_TLS¶: Cumasaíonn sé úsáid SSL don nasc stórais sonraí.

REDIS_VERIFY_SSL¶: Is féidir é a úsáid chun fíorú teastais SSL a dhíchumasú don nasc stórais sonraí.

Socrú freastalaí ríomhphoist¶

Chun go n-oibreoidh r-phost amach, ní mór duit freastalaí ríomhphoist a sholáthar.

Sampla de chumraíocht TLS:

environment:
    WEBLATE_EMAIL_HOST: smtp.example.com
    WEBLATE_EMAIL_HOST_USER: user
    WEBLATE_EMAIL_HOST_PASSWORD: pass

Sampla de chumraíocht 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

See also

Ríomhphoist amach a chumrú

WEBLATE_EMAIL_HOST¶

Óstainm freastalaí ríomhphoist nó seoladh IP.

See also

WEBLATE_EMAIL_PORT
WEBLATE_EMAIL_USE_SSL
WEBLATE_EMAIL_USE_TLS
EMAIL_HOST

WEBLATE_EMAIL_PORT¶: Port freastalaí ríomhphoist, réamhshocraithe go 25.

See also

EMAIL_PORT

WEBLATE_EMAIL_HOST_USER¶: Úsáideoir fíordheimhnithe ríomhphoist.

See also

EMAIL_HOST_USER

WEBLATE_EMAIL_HOST_PASSWORD¶

Pasfhocal fíordheimhnithe ríomhphoist.

See also

WEBLATE_EMAIL_USE_SSL¶

Cibé ar cheart nasc intuigthe TLS (slán) a úsáid agus tú ag caint leis an bhfreastalaí SMTP. I bhformhór na ndoiciméadú ríomhphoist, tagraítear don chineál seo de nasc TLS mar SSL. Úsáidtear é go ginearálta ar phort 465. Má tá fadhbanna agat, féach ar an socrú follasach TLS WEBLATE_EMAIL_USE_TLS.

Changed in version 4.11: Tá an tacaíocht SSL/TLS cumasaithe go huathoibríoch bunaithe ar an WEBLATE_EMAIL_PORT.

See also

WEBLATE_EMAIL_PORT
WEBLATE_EMAIL_USE_TLS
EMAIL_USE_SSL

WEBLATE_EMAIL_USE_TLS¶

Cibé ar cheart nasc TLS (slán) a úsáid agus tú ag caint leis an bhfreastalaí SMTP. Úsáidtear é seo le haghaidh naisc shainráite TLS, go ginearálta ar phort 587 nó 25. Má tá naisc ar crochadh agat, féach ar an socrú TLS intuigthe WEBLATE_EMAIL_USE_SSL.

Changed in version 4.11: Tá an tacaíocht SSL/TLS cumasaithe go huathoibríoch bunaithe ar an WEBLATE_EMAIL_PORT.

See also

WEBLATE_EMAIL_PORT
WEBLATE_EMAIL_USE_SSL
EMAIL_USE_TLS

WEBLATE_EMAIL_BACKEND¶

Cumraítear cúl-deireadh Django lena úsáid chun ríomhphoist a sheoladh.

Socraigh é go django_ses.SESBackend chun AWS SES a úsáid.

See also

WEBLATE_AWS_SES_REGION_NAME¶: Réigiún AWS do SES (m.sh. us-east-1). Socraíonn sé AWS_SES_REGION_NAME agus díorthaíonn sé WEBLATE_AWS_SES_REGION_ENDPOINT go huathoibríoch mura socraítear an t-athróg sin go sainráite. Mura socraítear é, ní mór don réigiún a bheith ar fáil trí shlabhra dintiúr caighdeánach boto3 (m.sh. AWS_DEFAULT_REGION nó próifíl AWS).

WEBLATE_AWS_SES_REGION_ENDPOINT¶: Ainm óstach an phointe foirceannta SES. Nuair a shocraítear é, cuirtear ar aghaidh chuig django-ses go díreach é, beag beann ar WEBLATE_AWS_SES_REGION_NAME. Mura socraítear é ach má chuirtear WEBLATE_AWS_SES_REGION_NAME ar fáil, úsáidtear email.<region>.amazonaws.com mar réamhshocrú. Déan an socrú seo a shárú má tá VPC nó pointe foirceannta saincheaptha á úsáid agat.

WEBLATE_USE_SES_V2¶: Socraigh go true é chun an API SES v2 (SendEmail) a úsáid in áit an ghlao dhílis SendRawEmail. Socrú Boole (úsáid "true" nó "false").

WEBLATE_AUTO_UPDATE¶

Cumraíonn sé cé acu agus conas ba cheart do Weblate stórtha a nuashonrú.

Sa réamhshocrú, "false", faightear athruithe cianda go laethúil gan iad a chumasc leis an gcóip oibre; ní dhéantar na nuashonruithe laethúla a dhíchumasú leis. Socraigh mar "true" é chun na hathruithe cianda a chumasc leis an gcóip oibre chomh maith.

See also

AUTO_UPDATE chun tuilleadh eolais a fháil faoin gcaoi a sceidealófar nuashonruithe i rith an lae.

Note

Is suíomh Boole é seo (úsáid "fíor" nó "bréagach").

Comhtháthú suímh¶

WEBLATE_GET_HELP_URL¶: Cumraíonn GET_HELP_URL.

WEBLATE_STATUS_URL¶: Cumraíonn STATUS_URL.

WEBLATE_LEGAL_URL¶: Cumraíonn LEGAL_URL.

WEBLATE_PRIVACY_URL¶: Cumraíonn PRIVACY_URL.

WEBLATE_PASSWORD_RESET_URL¶: Cumraíonn PASSWORD_RESET_URL.

Tuarascálacha earráide a bhailiú agus monatóireacht a dhéanamh ar fheidhmíocht¶

Moltar earráidí a bhailiú ón suiteáil go córasach, féach Tuarascálacha earráide a bhailiú agus monatóireacht a dhéanamh ar fheidhmíocht.

Chun tacaíocht do Rollbar a chumasú, socraigh an méid seo a leanas:

ROLLBAR_KEY¶: Do chomhartha rochtana do fhreastalaí poist Rollbar.

ROLLBAR_ENVIRONMENT¶: Do thimpeallacht Rollbar, réamhshocraithe go léiriú.

Chun tacaíocht do Sentry a chumasú, socraigh an méid seo a leanas:

SENTRY_DSN¶: Do Sentry DSN, féach SENTRY_DSN.

SENTRY_ENVIRONMENT¶: Do Thimpeallacht Sentry (roghnach), réamhshocrú go WEBLATE_SITE_DOMAIN.

SENTRY_MONITOR_BEAT_TASKS¶: Cibé acu ar cheart tascanna Celery Beat a mhonatóiriú le Sentry, is é True an rogha réamhshocraithe.

SENTRY_TRACES_SAMPLE_RATE¶

Cumraíonn SENTRY_TRACES_SAMPLE_RATE.

Sampla:

environment:
  SENTRY_TRACES_SAMPLE_RATE: 0.5

SENTRY_PROFILES_SAMPLE_RATE¶

Cumraíonn SENTRY_PROFILES_SAMPLE_RATE.

Sampla:

environment:
  SENTRY_PROFILES_SAMPLE_RATE: 0.5

SENTRY_SEND_PII¶: Cumraíonn SENTRY_SEND_PII.

Chun tacaíocht a chumasú do Thuairisciú Earráide Google Cloud, socraigh an méid seo a leanas:

GOOGLE_CLOUD_ERROR_REPORTING_ENABLED¶: Cumasaíonn sé GOOGLE_CLOUD_ERROR_REPORTING, réamhshocraithe go False.

GOOGLE_CLOUD_ERROR_REPORTING_PROJECT¶: Tionscadal Google Cloud le hearráidí a thuairisciú dó. Mura ndéantar é seo, úsáideann cliant Google dintiúir réamhshocraithe an fheidhmchláir chun an tionscadal a bhrath.

GOOGLE_CLOUD_ERROR_REPORTING_SERVICE¶: Ainm na seirbhíse le húsáid i dTuairisciú Earráide Google Cloud, réamhshocraithe go weblate.

Chun tacaíocht a chumasú do rianú OpenTelemetry, socraigh an méid seo a leanas:

OPENTELEMETRY_ENABLED¶: Cumasaíonn sé OPENTELEMETRY_ENABLED, réamhshocraithe go False.

OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT¶

Cumraigh OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT.

Sampla:

environment:
  OPENTELEMETRY_ENABLED: true
  OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT: https://collector.example.com/v1/traces
  OPENTELEMETRY_TRACES_SAMPLE_RATE: 0.1

OPENTELEMETRY_EXPORTER_OTLP_HEADERS¶: Cumraíonn sé OPENTELEMETRY_EXPORTER_OTLP_HEADERS mar mhapáil name:value atá scartha le camóga.

OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES¶: Cumraíonn sé OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES mar mhapáil name:value atá scartha le camóga.

OPENTELEMETRY_SERVICE_NAME¶: Cumraigh OPENTELEMETRY_SERVICE_NAME.

OPENTELEMETRY_TRACES_SAMPLE_RATE¶: Cumraigh OPENTELEMETRY_TRACES_SAMPLE_RATE.

Logánú CDN¶

WEBLATE_LOCALIZE_CDN_URL¶

WEBLATE_LOCALIZE_CDN_PATH¶

Added in version 4.2.1.

Cumraíocht le haghaidh breiseáin CDN, lena n-áirítear Logánú JavaScript CDN agus Comhaid aistriúcháin CDN.

Is é an WEBLATE_LOCALIZE_CDN_PATH an chonair laistigh den choimeádán. Ba cheart é a stóráil ar an toirt leanúnach agus ní sa stóráil neamhbhuan.

Ceann de na féidearthachtaí is ea é sin a stóráil taobh istigh den treoir sonraí Weblate:

environment:
  WEBLATE_LOCALIZE_CDN_URL: https://cdn.example.com/
  WEBLATE_LOCALIZE_CDN_PATH: /app/data/l10n-cdn

Note

Tá tú freagrach as freastal na gcomhad a ghineann Weblate a chur ar bun, ní stórálann sé na comhaid ach san áit chumraithe. Féach Logánú CDN le haghaidh treoir maidir le freastal slán.

See also

Athrú ar aipeanna, seiceálacha, formáidí, breiseáin, innealra nó uath-socruithe cumasaithe¶

Is féidir cumraíocht ionsuite seiceálacha cumasaithe, formáidí comhaid, breiseáin, innealra, nó uath-socruithe a choigeartú leis na hathróga seo a leanas:

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.

Sampla:

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

See also

Socruithe coimeádán¶

WEBLATE_WORKERS¶

Added in version 4.6.1.

Bunlíon na bpróiseas oibrithe atá ag rith sa choimeádán. Nuair nach bhfuil sé socraithe déantar é a chinneadh go huathoibríoch ar tosaithe coimeádán bunaithe ar líon na gcroí LAP atá ar fáil.

Úsáidtear é chun CELERY_MAIN_OPTIONS, CELERY_COMBINED_OPTIONS, CELERY_NOTIFY_OPTIONS, CELERY_MEMORY_OPTIONS, CELERY_TRANSLATE_OPTIONS, CELERY_BACKUP_OPTIONS, WEB_WORKERS, agus WEB_BLOCKING_THREADS a chinneadh. Is féidir leat na socruithe seo a úsáid chun mionchoigeartú a dhéanamh.

CELERY_WORKER_MODE¶

Added in version 2026.9.1.

Roghnaítear an chaoi a rithetar oibrithe Celery sa choimeádán. Is iad seo a leanas na modhanna a dtacaítear leo:

combined: Ritheann sé oibrí réamhfhorcála amháin do na scuainí uile. Seo an réamhshocrú agus laghdaíonn sé úsáid cuimhne trí chuimhne tosaithe an fheidhmchláir a roinnt. Is é WEBLATE_WORKERS an réamhshocrú comhthráthachta, agus is é a haon an réamhshocrú.
split: Ritheann sé próiseas oibreora ar leith prefork do gach scuaine. Freagraíonn sé seo do iompar na leaganacha coimeádáin roimh an leagan 2026.9.1, agus ceadaíonn sé gach scuaine a choigeartú go neamhspleách.
single: Ritheann sé gach scuaine i bpróiseas amháin ag baint úsáide as an linn aonair. Laghdaíonn sé seo úsáid na cuimhne a oiread agus is féidir, ach laghdaíonn sé go suntasach an ráta próiseála tascanna.

Tá tosaíocht ag roghnú sainráite an athróga timpeallachta WEBLATE_SERVICE ar an socrú seo i gcás imscaradh atá scálaithe go cothrománach.

CELERY_COMBINED_OPTIONS¶

Added in version 2026.9.1.

Cumraíonn sé seo an próiseas oibre a úsáidtear le CELERY_WORKER_MODE=combined. De réir réamhshocraithe, is ionann a chumas comh-reatha agus trí oiread WEBLATE_WORKERS. Úsáideann an próiseas oibre iolraitheoir réamh-aisghabhála (prefetch multiplier) a bhfuil luach a haon aige, mura n-athraítear é sin anseo.

environment:
  CELERY_COMBINED_OPTIONS: --concurrency 12 --prefetch-multiplier 1

See also

CELERY_MAIN_OPTIONS¶

CELERY_NOTIFY_OPTIONS¶

CELERY_MEMORY_OPTIONS¶

CELERY_TRANSLATE_OPTIONS¶

CELERY_BACKUP_OPTIONS¶

Cuireann na hathróga seo ar do chumas roghanna oibrí Celery a choigeartú nuair a bhaintear úsáid as CELERY_WORKER_MODE=split. D’fhéadfadh sé a bheith úsáideach an comhthráthacht (--concurrency 16) nó an réamhghnóthú (--prefetch-multiplier 4) a choigeartú, nó cur i bhfeidhm linn snámha (pool) difriúil a úsáid (--pool=gevent). Bíonn tosaíocht ag roghanna na líne orduithe ar na socruithe comhfhreagracha i Celery, rud a ligeann do gach catagóir oibrí iolraitheoir réamhghnóthaithe difriúil a úsáid. Nuair a shocraítear aon cheann de na hathróga seo i mód combined nó single, eisíonn an coimeádán rabhadh ag an tús á rá go ndéantar neamhaird orthu.

De réir réamhshocraithe, tá líon na n-oibrithe comhthráthacha bunaithe ar WEBLATE_WORKERS.

Sampla:

environment:
  CELERY_MAIN_OPTIONS: --concurrency 16 --prefetch-multiplier 1

See also

CELERY_BEAT_OPTIONS¶: Cumraíonn sé an sceidealóir Celery beat i ngach mód oibrí.

CELERY_SINGLE_OPTIONS¶

Cumraíonn sé an t-oibrí a úsáidtear le CELERY_WORKER_MODE=single.

See also

CELERY_SINGLE_PROCESS¶: Added in version 5.7.1.

Deprecated since version 2026.9.1.

Ailias comhoiriúnachta le haghaidh CELERY_WORKER_MODE=single. Nuair a shocraítear é go 1 gan CELERY_WORKER_MODE a bheith socraithe, tosaíonn an coimeádán sa mhód single agus logáiltear rabhadh ag iarraidh ort an socrú a nuashonrú. Má bhíonn an dá athróg socraithe, tugtar tús áite do CELERY_WORKER_MODE.

See also

Socrú Soilire aonphróisis

WEBLATE_ASGI¶

Added in version 2026.8.

Socraigh go 1 chun an feidhmchlár gréasáin a rith ag baint úsáide as ASGI in ionad WSGI. Is socrú rogha isteach é seo atá beartaithe chun an t-aistriú go ASGI a thástáil. Is é WSGI an socrú réamhshocraithe faoi láthair, ach ní rithfidh ach ASGI i leagan amach anseo agus bainfear an socrú seo.

environment:
  WEBLATE_ASGI: 1

WEB_WORKERS¶

Cumraigh cé mhéad oibrí feidhmchlár gréasáin ba chóir a fhorghníomhú.

Is leath de WEBLATE_WORKERS an réamhshocrú, ach bíonn sé i gcónaí ar a laghad 2.

Sampla:
environment:
  WEB_WORKERS: 4

Changed in version 5.13: Cumraíonn WEB_WORKERS cé mhéad próiseas oibrithe a úsáidfidh granian.

WEB_BLOCKING_THREADS¶

Cumraigh cé mhéad snáithe blocála WSGI is féidir le gach oibrí granian a úsáid. Is é an réamhshocrú ná WEBLATE_WORKERS faoi dhó agus déantar neamhaird de nuair a bhíonn WEBLATE_ASGI cumasaithe.

Is é an líon uasta iarratas WSGI comhuaineach ná WEB_WORKERS iolraithe faoi WEB_BLOCKING_THREADS. Is féidir le gach snáithe a nasc bunachar sonraí féin a shealbhú, mar sin coinnigh an t-iomlán mar thoradh laistigh den teorainn nasc bunachar sonraí.

Sampla:

environment:
  WEB_WORKERS: 2
  WEB_BLOCKING_THREADS: 8

WEBLATE_SERVICE¶

Sainmhíníonn cé na seirbhísí ba chóir a fhorghníomhú taobh Úsáid é seo le haghaidh Scálú go cothrománach.

Sainmhínítear na seirbhísí seo a leanas:

celery-beat: Sceidealóir tasc soilire, níor cheart ach sampla amháin a bheith ar siúl. Tá an coimeádán seo freagrach freisin as aistrithe struchtúr an bhunachair shonraí agus ba cheart é a thosú roimh chinn eile.
celery-backup: Oibrí soilire le haghaidh cúltacaí, níor cheart ach sampla amháin a bheith ar siúl.
celery-combined: Oibrí Celery comhcheangailte do gach scuaine tascanna.
celery-celery: Oibrí Soilire Cineálach.
celery-memory: Cuimhne aistriúcháin Oibrí soilire.
celery-notify: Fógraí Oibrí soilire.
celery-single: Oibrí Celery aonphróisis do gach scuaine tascanna.
celery-translate: Aistriúchán uathoibríoch Oibrí soilire.
web: Freastalaí gréasáin.

See also

Inmheánaigh tascanna cúlra

WEBLATE_ANUBIS_URL¶

Added in version 5.11.4.

URL an fhreastalaí Anubis chun fíordheimhniú fo-iarrata a láimhseáil. Is féidir leis seo a bheith úsáideach chun iarratais HTTP isteach a scagadh ag baint úsáide as cruthúnas oibre chun crawlers AI a stopadh. Ní mór duit Anubis le haghaidh Fíordheimhniú Fo-iarrata a chumrú chun go n-oibreoidh sé.

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.

See also

Comhtháthú coimeádán Anubis Docker
Anubis

Toirteanna coimeádán docker¶

Tá dhá imleabhar (data agus cache) á n-easpórtáil ag coimeádán Weblate.

Note

Tá a dtoirt sonraí féin ag na coimeádáin seirbhíse eile (amhail PostgreSQL nó Valkey) chomh maith agus tá siad riachtanach chun buanseasmhacht Weblate a choinneáil.

Stórálann an coimeádán PostgreSQL an bunachar sonraí san imleabhar /var/lib/postgresql agus Valkey san imleabhar /data. Ní shábhálann coimeádán Valkey na sonraí de réir réamhshocraithe agus teastaíonn cumraíocht bhreise uaidh chun buanseasmhacht a chumasú.

Bunaigh do chumraíocht ar shamplaí arna soláthar ag Weblate nó féach ar a ndoiciméadacht le haghaidh tuilleadh eolais.

Tá an toirt data gléasta mar /app/data agus úsáidtear é chun sonraí marthanacha Weblate a stóráil ar nós stórtha clónáilte nó chun suiteáil Weblate a shaincheapadh. Déanann DATA_DIR cur síos níos mine ar a bhfuil stóráilte anseo.

Is áit í an toirt data freisin chun saincheapadh Weblate a stóráil amhail Socruithe sáraitheacha ón méid sonraí, Lógó agus comhaid statacha eile a athsholáthar nó Cód a shaincheapadh.

Braitheann socrúchán toirt Docker ar chóras óstach ar do chumraíocht Docker, ach de ghnáth stóráiltear é in /var/lib/docker/volumes/weblate-docker_weblate-data/_data/ (tá ainm d'eolaire docker-componc, coimeádán agus ainmneacha toirte sa chosán).

Tá an toirt cache feistithe mar /app/cache agus úsáidtear é chun comhaid statach agus CACHE_DIR a stóráil. Athchruthaítear a ábhar nuair a thosaítear an coimeádán agus is féidir an toirt a fheistiú ag baint úsáide as córas comhad neamhbhuan ar nós tmpfs, ach caithfidh an feistiú ligean do fhorghníomhú toisc go stórálann Weblate comhaid chúnta ginte ann.

Agus /app/cache á fheistiú go sainráite mar tmpfs i Docker Compose, cumasaigh an forghníomhú:

tmpfs:
  - /app/cache:exec

Agus roghanna úinéireachta á socrú agat freisin, coinnigh an rogha exec:

tmpfs:
  - /app/cache:exec,uid=1000,gid=1000

Agus na méideanna á gcruthú de láimh, ba cheart go mbeadh na heolairí faoi úinéireacht AitheantasÚsáideora 1000 mar is é sin an t-úsáideoir a úsáidtear taobh istigh den choimeádán.

Is féidir coimeádán Weblate a fhorghníomhú le córas comhad fréimhe inléite amháin freisin. Sa chás seo, ba chóir dhá imleabhar tmpfs breise a fheistiú: /tmp agus /run.

See also

Córas fréimhe inléite amháin¶

Added in version 4.18.

Agus an coimeádán á rith le córas comhaid fréimhe inléite amháin, tá gá le dhá imleabhar breise tmpfs - /tmp agus /run.

Cumraíocht thar athróga timpeallachta¶

Tá sé mar aidhm ag Docker environment variables an chuid is mó de configuration settings atá ábhartha do shuiteálacha Weblate a nochtadh.

Má aimsíonn tú socrú nach bhfuil nochta mar athróg timpeallachta, agus má chreideann tú gur cheart go mbeadh, bíodh leisce ort ask for it to be exposed in a future version of Weblate.

Más gá duit socrú nach bhfuil nochtaithe mar athróg timpeallachta Docker a mhodhnú, is féidir leat é sin a dhéanamh fós, ceachtar from the data volume no extending the Docker image.

See also

Weblate a shaincheapadh

Socruithe sáraitheacha ón méid sonraí¶

Is féidir leat comhad a chruthú ag /app/data/settings-override.py, i.e. ag fréamh an data volume, chun socruithe atá sainmhínithe trí athróga comhshaoil a leathnú nó a shárú.

Socruithe a shárú trí íomhá an Docker a leathnú¶

Chun socruithe ag leibhéal íomhá an Docker a shárú seachas ón méid sonraí:

Cruthaigh pacáiste Python saincheaptha.
Cuir modúl le do phacáiste a iompórtálann gach socrú ó weblate.settings_docker.

Mar shampla, laistigh den struchtúr pacáiste sampla a shainítear ag Modúl Python a chruthú, d'fhéadfá comhad a chruthú ag weblate_customization/weblate_customization/settings.py leis an gcód tosaigh seo a leanas:
```
from weblate.settings_docker import *
```

Cruthaigh Dockerfile saincheaptha a gheobhaidh oidhreacht ón íomhá oifigiúil Weblate Docker, agus ansin suiteáil do phacáiste agus díríonn an t-athróg timpeallachta DJANGO_SETTINGS_MODULE chuig do mhodúl socruithe:

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

In ionad an íomhá oifigiúil Weblate Docker a úsáid, tóg íomhá saincheaptha ón gcomhad Dockerfile seo.

There is no clean way to do this with docker-compose.override.yml. You could add build: . to the weblate node in that file, but then your custom image will be tagged as weblate/weblate in your system, which could be problematic.

Mar sin, in ionad an docker-compose.yml a úsáid díreach ón stór oifigiúil, gan mhodhnú, agus é a leathnú trí docker-compose .override.yml, b'fhéidir gur mhaith leat cóip den chomhad oifigiúil docker-compose.yml a dhéanamh, agus do chóip a chur in eagar chun image: weblate/weblate a chur in ionad build: ..

Féach an Compose file build reference le haghaidh sonraí maidir le híomhánna a thógáil ón bhfoinse agus docker-compose in úsáid.
Leathnaigh do mhodúl socruithe saincheaptha chun socruithe a shainiú nó a ath-shainmhíniú.

Is féidir leat socruithe a shainiú roimh nó tar éis an ráitis iompórtála thuas chun a chinneadh cé na socruithe a bhfuil tosaíocht acu. Is féidir le hathróga timpeallachta socruithe arna sainiú roimh an ráiteas allmhairithe a shárú agus is féidir sáruithe socraithe a shainítear sa toirt sonraí. Ní féidir an socrú a shainítear tar éis an ráitis allmhairithe a shárú.

You can also go further. For example, you can reproduce some of the things that weblate.docker_settings does, such as exposing settings as environment variables, or allow overriding settings from Python files in the data volume.

Lógó agus comhaid statacha eile a athsholáthar¶

Is féidir na comhaid statacha a thagann le Weblate a athshealbhú trí chur isteach i /app/data/python/customize/static (féach Toirteanna coimeádán docker). Mar shampla cruthóidh /app/data/python/customize/static/favicon.ico in ionad an favicon.

Hint

Déantar na comhaid a chóipeáil go dtí an suíomh comhfhreagrach nuair a thosaítear an coimeádán, mar sin tá gá le Weblate a atosú tar éis inneachar na toirte a athrú.

Is féidir an cur chuige seo a úsáid freisin chun teimpléid Weblate a shárú. Mar shampla, is féidir doiciméid agus stíleanna saincheaptha Modúl dlí a sholáthar mar a thuairiscítear i Doiciméid agus stíleanna dlíthiúla a shaincheapadh.

Nó is féidir leat an modúl féin a chur san áireamh freisin (féach Weblate a shaincheapadh) agus é a chur mar imleabhar ar leith le coimeádán an Docker, mar shampla:

weblate:
  volumes:
    - weblate-data:/app/data
    - ./weblate_customization/weblate_customization:/app/data/python/weblate_customization
  environment:
    WEBLATE_ADD_APPS: weblate_customization

Cód a shaincheapadh¶

Note

D’fhéadfadh athrú suntasach a bheith ar API inmheánach Weblate idir scaoileadh agus níl sé beartaithe go mbeidh sé cobhsaí. Déan athbhreithniú ar do chód saincheaptha ag idirghníomhú le comhpháirteanna inmheánacha Weblate ar gach uasghrádú.

Is féidir leat cód Python breise a chur isteach i /app/data/python/customize (féach Toirteanna coimeádán docker). Tá sé suiteáilte cheana féin mar fheidhmchlár Django laistigh de Weblate (úsáidtear é seo chun teimpléid agus comhaid statach a shaincheapadh mar a thuairiscítear thuas).

Is féidir é seo a úsáid chun aon chód a chur (mar shampla Ag scríobh seiceanna féin) nó chun tascanna cothabhála saincheaptha a chur leis an sceidealóir tascanna 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"
    )

Coimeádáin tríú páirtí a chomhtháthú¶

Is féidir socrú Docker Weblate a leathnú le coimeádáin bhreise chun seirbhísí comhlántacha a sholáthar amhail aistriúchán meaisín, seiceáil litrithe, nó uirlisí eile a fheabhsaíonn an sreabhadh oibre aistriúcháin. Is féidir na seirbhísí seo a chomhtháthú i do chumraíocht Docker Compose agus oibriú taobh le taobh le Weblate.

Agus coimeádáin tríú páirtí á gcur leis, smaoinigh ar na nithe seo a leanas:

Nascacht líonra: Cinntigh gur féidir le coimeádáin cumarsáid a dhéanamh lena chéile trína gcur ar an líonra Docker céanna
Buanseasmhacht sonraí: Úsáid toirteanna le haghaidh seirbhísí a bhfuil gá acu le sonraí a bhuanú
Slándáil: Cumraigh rialuithe rochtana cuí agus seachain nochtadh calafoirt neamhriachtanacha

Comhtháthú coimeádán Docker LibreTranslate¶

Is seirbhís aistriúcháin meaisín saor in aisce agus foinse oscailte í LibreTranslate ar féidir í a óstáil féin. Trí í a chomhtháthú le Weblate, soláthraítear cumais aistriúcháin meaisín as líne gan a bheith ag brath ar sheirbhísí seachtracha.

Is féidir leat an tseirbhís LibreTranslate a ionchorprú i do imscaradh Weblate trína chur san áireamh i gcomhad docker-compose.override.yml. Ós rud é go ritheann sé laistigh de líonra Docker, níl rochtain air ach ag Weblate agus níl sé nochtaithe don idirlíon poiblí.

Socrú bunúsach ag baint úsáide as 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:

Le haghaidh aistriúcháin luasghéaraithe GPU (má tá GPU NVIDIA ar fáil agat):

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:

Tar éis na seirbhísí a thosú le docker compose down && docker compose up -d, cumraigh LibreTranslate i Weblate:

Rochtain ar chomhéadan riaracháin Weblate
Téigh go Aistriúchán meaisín → Moltaí uathoibríocha
Cuir seirbhís nua LibreTranslate leis le:

Seirbhís:

LibreTranslate

URL API:

http://libretranslate:5000

Eochair API:

Fág folamh

Tá LibreTranslate cumraithe anois agus ar fáil le haghaidh aistriúcháin meaisín i Weblate.

Note

Ritheann seirbhís LibreTranslate gan an chomhéadan gréasáin (--disable-web-ui) agus níl rochtain uirthi ach tríd an API laistigh de líonra Docker.
Nuashonraítear samhlacha go huathoibríoch nuair a thosaíonn an coimeádán. (LT_UPDATE_MODELS: fíor)
Coinnítear sonraí ag baint úsáide as imleabhair Docker chun feidhmíocht agus sábháilteacht sonraí is fearr a bhaint amach.
Cinntíonn seiceálacha sláinte go ndéanann inneall Docker breathnú i gceart ar staid na seirbhíse.
Chun luasghéarú GPU a dhéanamh, bain úsáid as an leagan íomhá CUDA agus cinntigh go bhfuil tacaíocht NVIDIA Docker ag do chóras. Ritheann an coimeádán seo mar úsáideoir pribhléideach chun an GPU a úsáid.
Níl aon chalafoirt sheachtracha nochta, rud a fhágann go bhfuil an socrú slán de réir réamhshocraithe.

See also

Comhtháthú coimeádán Anubis Docker¶

Is fóntais balla dóiteáin gréasáin AI é Anubis chun scríobadóirí AI agus trácht suaiteach eile ar an bhfreastalaí a bhac. De ghnáth bíonn gá leis le haghaidh suiteálacha Weblate atá oscailte go poiblí chun ualach iomarcach de bharr scríobtha a sheachaint.

Is féidir Anubis a imscaradh ag baint úsáide as 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:

Note

Táthar ag súil go mbeidh botPolicies.yaml sa toirt anubis-data sa chumraíocht thuas agus polasaí bot ann atá cumraithe de réir do riachtanas.

Ar a laghad, ní mór duit cóid stádais a choigeartú mar a thuairiscítear i https://anubis.techaro.lol/docs/admin/configuration/subrequest-auth.

Moltar freisin an cúltaca stórála buan a chumrú mar a thuairiscítear i https://anubis.techaro.lol/docs/admin/policies/#storage-backends.

Ansin is féidir leat úsáid Anubis a chasadh air i Weblate ag baint úsáide as:

environment:
   WEBLATE_ANUBIS_URL: http://anubis:8923

See also

WEBLATE_ANUBIS_URL

Freastalaí PostgreSQL á chumrú¶

Úsáideann coimeádán PostgreSQL cumraíocht réamhshocraithe PostgreSQL agus ní bhainfidh sé úsáid éifeachtach as do chroíleacáin LAP ná as do chuimhne. Moltar an chumraíocht a shaincheapadh chun an fheidhmíocht a fheabhsú.

Is féidir an chumraíocht a choigeartú mar a thuairiscítear i Cumraíocht Bunachar Sonraí ag https://hub.docker.com/_/postgres. Is féidir an chumraíocht a mheaitseálann do thimpeallacht a ghiniúint ag baint úsáide as https://pgtune.leopard.in.ua/.

Inmheánach coimeádán¶

Tá an coimeádán ag baint úsáide supervisor chun seirbhísí aonair a thosú. I gcás Scálú go cothrománach, ní thosaíonn sé ach seirbhís aonair i gcoimeádán.

Úsáid stádas na seirbhísí a sheiceáil:

docker compose exec --user weblate weblate supervisorctl status

Braitheann na seirbhísí Celery ar CELERY_WORKER_MODE. Ritheann an mód réamhshocraithe combined an próiseas celery-combined, agus ritheann an mód single an próiseas celery-single. Is féidir leat gach próiseáil tascanna a stopadh sa mhód réamhshocraithe trí úsáid a bhaint as:

docker compose exec --user weblate weblate supervisorctl stop celery-combined

Ritheann an mód split seirbhís ar leith do gach scuaine Celery (féach Tascanna cúlra ag baint úsáide as Soilire le haghaidh tuilleadh sonraí). Sa mhód seo, is féidir leat próiseáil tascanna áirithe a stopadh trí stop a chur leis an oibrí cuí:

docker compose exec --user weblate weblate supervisorctl stop celery-translate