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.

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

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

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	Rolling updates within a calendar year in a production environment
`<YEAR>.<MONTH>`	Scaoileadh cobhsaí Weblate	Rolling updates within a monthly release in a production environment
`<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

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

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 Treoracha leagan ar leith.

B'fhéidir gur mhaith leat an stór docker-compose a nuashonrú freisin, cé nach bhfuil sé ag teastáil i bhformhór na gcásanna. Féach Coimeádán PostgreSQL a uasghrádú chun an freastalaí PostgreSQL a uasghrádú.

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 go huathoibríoch líon na bpróiseas oibrithe don WSGI agus don Soilire araon bunaithe ar líon na LAPanna. Oibríonn sé seo go maith don chuid is mó de mheaisíní fíorúla scamall mar go hiondúil is beag LAPanna a bhíonn acu agus méid maith cuimhne.

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 catagóirí oibrithe aonair a mhionchoigeartú freisin:

environment:
  WEB_WORKERS: 4
  CELERY_MAIN_OPTIONS: --concurrency 2
  CELERY_NOTIFY_OPTIONS: --concurrency 1
  CELERY_TRANSLATE_OPTIONS: --concurrency 1

Is féidir úsáid na cuimhne a laghdú tuilleadh trí phróiseas Soilire amháin a rith:

environment:
  CELERY_SINGLE_PROCESS: 1

See also

WEBLATE_WORKERS
CELERY_MAIN_OPTIONS
CELERY_NOTIFY_OPTIONS
CELERY_MEMORY_OPTIONS
CELERY_TRANSLATE_OPTIONS
CELERY_BACKUP_OPTIONS
CELERY_BEAT_OPTIONS
CELERY_SINGLE_PROCESS
WEB_WORKERS

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.

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¶

Cumraíonn sé fearann an tsuímh. Tá an paraiméadar seo ag teastáil.

Cuir port san áireamh má tá ceann neamhchaighdeánach á úsáid agat.

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.

Configures PROJECT_WEB_RESTRICT_ALLOWLIST.

Expects a comma-separated list of trusted project slugs.

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.

Expects a comma-separated list of trusted hostnames or domains.

WEBLATE_ASSET_RESTRICT_PRIVATE¶

Added in version 2025.5.

Configures ASSET_RESTRICT_PRIVATE.

Réamhshocraithe go cumasaithe.

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¶

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.

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_IP_PROXY_OFFSET¶: Added in version 5.0.1.

Cumraíonn IP_PROXY_OFFSET.

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¶

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.

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 deimhniú téarmaí seirbhíse 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.

Sampla:

environment:
  WEBLATE_LEGAL_INTEGRATION: tos-confirm

See also

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

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¶: Cumraigh réimír URL an áit a bhfuil Weblate ag rith, féach URL_PREFIX.

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é teorainn ráta API. Is é 100/lá an rogha réamhshocraithe d'úsáideoirí gan ainm agus 5000/uair d'úsáideoirí fíordheimhnithe.

See also

Teorainn ráta API

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

WEBLATE_UNUSED_ALERT_DAYS¶: Added in version 4.17.

Cumraíonn UNUSED_ALERT_DAYS.

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_ALLOW_SCHEMES¶: Added in version 5.15.

Cumraíonn VCS_ALLOW_SCHEMES.

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.

Cumraíonn sé uasmhéid coirp a nglacann an freastalaí gréasáin ionsuite leis.

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¶

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_SIZE is 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.

Dintiúir suímh óstála cód¶

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 Iarratais tharraingt GitHub, but apply to all Comhtháthú rialaithe leagan with appropriately changed variable names.

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¶: Configures Iarratais tharraingt GitHub by changing GITHUB_CREDENTIALS.

See also

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

WEBLATE_GITLAB_USERNAME¶

WEBLATE_GITLAB_TOKEN¶

WEBLATE_GITLAB_HOST¶

WEBLATE_GITLAB_CREDENTIALS¶: Configures Iarratais chumasc GitLab by changing GITLAB_CREDENTIALS.

See also

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

WEBLATE_GITEA_USERNAME¶

WEBLATE_GITEA_TOKEN¶

WEBLATE_GITEA_HOST¶

WEBLATE_GITEA_CREDENTIALS¶: Configures Iarratais tarraingt Gitea by changing GITEA_CREDENTIALS.

See also

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

WEBLATE_PAGURE_USERNAME¶

WEBLATE_PAGURE_TOKEN¶

WEBLATE_PAGURE_HOST¶

WEBLATE_PAGURE_CREDENTIALS¶: Configures leathanach iarratais chumaisc by changing PAGURE_CREDENTIALS.

See also

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

WEBLATE_BITBUCKETSERVER_USERNAME¶

WEBLATE_BITBUCKETSERVER_TOKEN¶

WEBLATE_BITBUCKETSERVER_HOST¶

WEBLATE_BITBUCKETSERVER_CREDENTIALS¶: Configures Iarratais ar tharraingt Ionad Sonraí Bitbucket by changing BITBUCKETSERVER_CREDENTIALS.

WEBLATE_BITBUCKETCLOUD_USERNAME¶

WEBLATE_BITBUCKETCLOUD_WORKSPACE¶

WEBLATE_BITBUCKETCLOUD_TOKEN¶

WEBLATE_BITBUCKETCLOUD_HOST¶

WEBLATE_BITBUCKETCLOUD_CREDENTIALS¶: Configures Iarratais ar tharraingt Bitbucket Cloud by changing BITBUCKETCLOUD_CREDENTIALS.

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¶: Configures Iarratais tarraingthe Azure DevOps by changing AZURE_DEVOPS_CREDENTIALS.

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

Set to false to disable environment based configuration of the database connection. Use Socruithe sáraitheacha ón méid sonraí to configure the database connection manually.

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.

See also

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

See also

AUTO_UPDATE

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.

Logánú CDN¶

WEBLATE_LOCALIZE_CDN_URL¶

WEBLATE_LOCALIZE_CDN_PATH¶

Added in version 4.2.1.

Configuration for CDN add-ons, including Logánú JavaScript CDN and Translation files 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

You are responsible for setting up serving of the files generated by Weblate, it only stores the files in configured location. See Logánú CDN for secure serving guidance.

See also

Aipeanna cumasaithe a athrú, seiceálacha, breiseáin, aistriúchán meaisín nó uathshocrú¶

Is féidir cumraíocht ionsuite na seiceálacha cumasaithe, na mbreiseán nó na socruithe uathoibríocha 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_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_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 a chinneadh CELERY_MAIN_OPTIONS, CELERY_NOTIFY_OPTIONS, CELERY_MEMORY_OPTIONS, CELERY_TRANSLATE_OPTIONS, CELERY_BACKUP_OPTIONS, CELERY_BEAT_OPTIONS, agus WEB_WORKERS. Is féidir leat na socruithe seo a úsáid chun mionchoigeartú.

CELERY_MAIN_OPTIONS¶

CELERY_NOTIFY_OPTIONS¶

CELERY_MEMORY_OPTIONS¶

CELERY_TRANSLATE_OPTIONS¶

CELERY_BACKUP_OPTIONS¶

CELERY_BEAT_OPTIONS¶

Ligeann na hathróga seo duit roghanna oibrithe Soilire a choigeartú. Is féidir go mbeadh sé úsáideach concurrency (--concurrency 16) a choigeartú nó cur i bhfeidhm difriúil linn snámha a úsáid (--pool = gevent).

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

Sampla:

environment:
  CELERY_MAIN_OPTIONS: --concurrency 16

See also

CELERY_SINGLE_PROCESS¶

Added in version 5.7.1: Is féidir an athróg seo a shocrú go 1 chun próiseas soilire amháin a rith. Laghdaíonn sé seo úsáid chuimhne ach d'fhéadfadh tionchar a bheith aige ar fheidhmíocht Weblate.

environment:
  CELERY_SINGLE_PROCESS: 1

See also

Socrú Soilire aonphróisis

WEB_WORKERS¶

Cumraigh cé mhéad oibrí WSGI ba cheart 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.

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-celery: Oibrí Soilire Cineálach.
celery-memory: Cuimhne aistriúcháin Oibrí soilire.
celery-notify: Fógraí Oibrí soilire.
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é.

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

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

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.

Níl aon bhealach glan <https://github.com/docker/compose/issues/7231>`__ ann chun seo a dhéanamh le docker-compose.override.yml. D’fhéadfá build: . a chur leis an nód weblate sa chomhad sin, ach ansin beidh d’íomhá saincheaptha clibeáilte mar weblate/weblate i do chóras, rud a d’fhéadfadh a bheith ina fhadhb.

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

Is féidir leat dul níos faide freisin. Mar shampla, is féidir leat cuid de na rudaí a dhéanann weblate.docker_settings `` a atáirgeadh <https://github.com/WebateOrg/weblate/blob/main/weblate/settings_docker.py>`__, mar shampla socruithe a nochtadh mar athróga timpeallachta, nó cead a thabhairt do shocruithe sáraitheacha ó chomhaid Python sa toirt sonraí.

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 Ghréasán a shárú. Mar shampla is féidir Modúl dlí doiciméid a chur isteach i /app/data/python/customize/templates/legal/documents.

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

import subprocess  # noqa: S404

from celery.schedules import crontab

from weblate.utils.celery import app


@app.task
def custom_task() -> None:
    """Execute custom task code."""
    subprocess.run(["sleep", "1"], check=True)  # noqa: S607


@app.on_after_finalize.connect
def setup_periodic_tasks(sender, **kwargs) -> 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

Tá seirbhísí aonair do gach scuaine Soilire (féach Tascanna cúlra ag baint úsáide as Soilire le haghaidh sonraí). Is féidir leat roinnt tascanna a phróiseáil tríd an oibrí cuí a stopadh:

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