Configuration

Tots els paràmetres s’emmagatzemen a settings.py (com és habitual per a Django).

Nota

Després de canviar qualsevol d’aquestes configuracions, heu de reiniciar Weblate, tant els processos WSGI com Celery.

En cas que s’executi com a mod_wsgi, cal que reinicieu Apache per tornar a carregar la configuració.

Vegeu també

Consulteu també la documentació de Django per als paràmetres que configuren Django.

ADMINS_CONTACT

Configura on el formulari de contacte envia correus electrònics. Si no està configurat, s’utilitzen les adreces de correu electrònic de ADMINS.

Configure this as a list of e-mail addresses:

ADMINS_CONTACT = ["admin@example.com", "support@example.com"]

Vegeu també

ALLOWED_ASSET_DOMAINS

Afegit a la versió 5.14.

Configura quins dominis es permeten obtenir recursos a Weblate.

Això millora la seguretat evitant que es carreguin actius de fonts no fiables. Els actius es descarreguen una vegada pel servidor Weblate i s’emmagatzemen localment, en lloc de ser servits directament des de dominis externs als usuaris.

La llista de permisos s’aplica a l’URL inicial i a cada objectiu de redirecció HTTP abans que Weblate la segueixi. Es rebutgen les redireccions a amfitrions fora d’aquesta llista de permisos.

S’espera una llista de noms d’amfitrió/domini. Podeu utilitzar noms totalment qualificats (p. ex., www.example.com) o afegir un punt com a comodí per fer coincidir tots els subdominis (per exemple, .example.com coincidirà amb cdn.example.com o static.example.com).

El valor per defecte és ["*"], que permet tots els dominis.

Example

ALLOWED_ASSET_DOMAINS = [
    # Allows only cdn.anotherdomain.org
    "cdn.anotherdomain.org",
    # Allows example.com and all its subdomains
    ".example.com",
]

This is currently used in the following places:

Vegeu també

ALLOWED_MACHINERY_DOMAINS

Configura quins dominis de maquinària personalitzada es permeten explícitament a la configuració de traducció automàtica a nivell de projecte.

Aquesta configuració només s’aplica als serveis de maquinària i no afecta ALLOWED_ASSET_DOMAINS.

S’espera una llista de noms d’amfitrió/domini. Podeu utilitzar noms totalment qualificats o afegir un punt com a comodí per fer coincidir tots els subdominis.

Defaults to [].

The allowlist affects project-managed machinery in two ways: it permits the configured endpoint during outbound validation, and it marks matching hosts as trusted when deciding whether remote provider error details or response bodies can be shown to the user. Matching hosts are also exempt from private-target restrictions. For direct connections, Weblate does not resolve, pin, or verify the peer address of matching hosts. Only add hosts or domains whose network destinations are trusted. When a configured Proxy HTTP is used, the proxy is trusted to resolve the destination hostname.

ALLOWED_ASSET_SIZE

Afegit a la versió 5.14.

Configures size limit in bytes for fetching or uploading assets into Weblate. Defaults to 10 MB.

Vegeu també

ASSET_PRIVATE_ALLOWLIST

Afegit a la versió 2025.5.

Defineix noms d’amfitrió o dominis exempts de ASSET_RESTRICT_PRIVATE per a les baixades d’actius remots que obliguen a les comprovacions d’objectius privats. Les entrades segueixen la semàntica de concordança de l’amfitrió de Django, de manera que es poden utilitzar valors com assets.internal.example o .internal.example.

Això no substitueix ALLOWED_ASSET_DOMAINS; els recursos remots encara han de coincidir amb la llista de dominis d’actius.

Default configuration:

ASSET_PRIVATE_ALLOWLIST = []

Vegeu també

ASSET_RESTRICT_PRIVATE

Afegit a la versió 2025.5.

Rebutja els URL de recursos remots que apunten a adreces internes o no públiques tret que l’amfitrió de destinació estigui inclòs a ASSET_PRIVATE_ALLOWLIST. Activat per defecte.

Quan està activat, els noms d’amfitrió que no es poden resoldre durant la validació es rebutgen tret que s’incloguin explícitament a ASSET_PRIVATE_ALLOWLIST. Això s’aplica actualment a les càrregues d’URL de captures de pantalla i a les descàrregues HTML remotes per al complement CDN de localització de JavaScript.

Vegeu també

ALTCHA_COST

Afegit a la versió 2025.5.

Cost de temps d’Argon2id per al repte de prova de treball ALTCHA. El valor per defecte és 3.

Substitueix ALTCHA_MAX_NUMBER, que s’aplicava al giny ALTCHA v2 eliminat.

ALTCHA_MEMORY_COST

Afegit a la versió 2025.5.

Cost de memòria Argon2id en KiB. El valor predeterminat és 65536.

ALTCHA_PARALLELISM

Afegit a la versió 2025.5.

Factor de paral·lelisme Argon2id. El valor predeterminat és 1.

Vegeu també

ALTCHA Proof of Work Mechanism

ANONYMOUS_USER_NAME

Nom d’usuari dels usuaris que no han iniciat sessió.

Vegeu també

Control d’accés

AUDITLOG_EXPIRY

El nombre màxim de dies Weblate mantindrà registres d’auditoria que continguin informació sobre l’activitat del compte.

Per defecte, 180 dies.

AUTH_LOCK_ATTEMPTS

Nombre màxim d’intents d’autenticació fallits abans que s’apliqui la limitació de velocitat.

Actualment s’aplica a les ubicacions següents:

  • Inicieu la sessió. Suprimeix la contrasenya del compte, impedint que l’usuari iniciï sessió sense demanar una nova contrasenya.

  • Second-factor sign in. Deletes the account password after this many rejected second-factor submissions since the last successful second-factor sign in. This also invalidates pending password sign-ins. Other authentication methods and API tokens remain usable.

  • Restableix la contrasenya. Evita que s’enviïn missatges de correu electrònic nous, evitant que els usuaris facin correu brossa amb massa intents de restabliment de la contrasenya.

El valor per defecte és 10.

Vegeu també

Limitació de tarifes

AUTO_UPDATE

Actualitza tots els repositoris diàriament.

Every hour, Weblate queues updates for repositories whose component ID modulo 24 matches the current UTC hour. This distributes updates throughout the day. For example, component ID 25 is selected during the hour from 01:00 to 01:59 UTC. Linked components use the schedule of the component that owns their shared repository.

The assigned hour determines when updates are queued, not when they finish. Execution can be delayed by queued tasks or repository operations. Restarting Celery does not change the assigned hour. This setting does not provide a configurable update time window.

Suggeriment

Útil si no feu servir Punts d’inserció de notificacions per actualitzar automàticament els repositoris de Weblate.

Nota

Hi ha opcions d’activació/desactivació a més de la selecció de cadenes per a la compatibilitat enrere.

Les opcions són:

"none"

No hi ha actualitzacions diàries.

"remot" també False

Fetch remote changes without merging them into the working copy. This is the default; False does not disable daily updates.

"complet" també Veritat

Fetch remote changes and merge them into the working copy.

Nota

Automatic updates require that Tasques de fons amb api is working. Restart Celery after changing this setting for the new value to take effect.

AVATAR_URL_PREFIX

Prefix per construir URL d’avatar com: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Se sap que funcionen els següents serveis:

Gravatar (per defecte), segons https://gravatar.com/

AVATAR_URL_PREFIX = 'https://www.gravatar.com/'

Libravatar, segons https://www.libravatar.org/

AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

Vegeu també

AVATAR_URL_TEMPLATE

Afegit a la versió 2026.10.

Template to generate avatar URLs. Defaults to "{AVATAR_URL_PREFIX}avatar/{mail_hash}?{querystring}".

It can contain {AVATAR_URL_PREFIX}, {mail_hash}, {querystring}, {username}, and {size}.

For example, to fetch avatars by username instead of e-mail hash (as needed by Codeberg’s Forgejo-backed avatar service):

AVATAR_URL_TEMPLATE = "{AVATAR_URL_PREFIX}avatar/{username}/{size}"

Vegeu també

AUTH_TOKEN_VALID

How long the authentication token and temporary password from password reset e-mails is valid for. Set in number of seconds, defaulting to 172800 (2 days). E-mail validation codes are checked against this lifetime when used, even if scheduled cleanup has not yet removed them. This does not set a deadline for other authentication pipeline steps.

AUTH_PASSWORD_DAYS

How many days Weblate rejects reusing a previously used password for a user.

La comprovació es basa en el registre d’auditoria, AUDITLOG_EXPIRY ha de ser almenys el mateix que aquest.

Nota

Els canvis de contrasenya fets abans de Weblate 2.15 no es tindran en compte en aquesta política.

Per defecte, 180 dies.

AUTOFIX_LIST

Llista de correccions automàtiques per aplicar en desar una cadena.

Nota

Proporcioneu un camí completament qualificat a la classe Python que implementa la interfície de fixació automàtica.

Les correccions disponibles es descriuen a Correccions automàtiques.

Podeu seleccionar quines voleu utilitzar:

AUTOFIX_LIST = (
    "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
    "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)

Vegeu també

BACKGROUND_TASKS

Afegit a la versió 4.5.2.

Defineix la freqüència amb què s’han d’activar tasques de manteniment llargues per a un component.

Ara mateix això controla:

Possible choices:

  • mensual (aquest és el valor predeterminat)

  • weekly

  • daily

  • never

Nota

No es recomana augmentar la freqüència quan Weblate conté milers de components.

BASIC_LANGUAGES

Afegit a la versió 4.4.

Llista d’idiomes per oferir als usuaris per començar una nova traducció. Quan no s’especifica, s’utilitza una llista integrada (que inclou tots els idiomes d’ús habitual, però sense variants específiques del país).

Això només limita els usuaris sense privilegis per afegir idiomes no desitjats. Els administradors del projecte encara es presenten amb la selecció completa d’idiomes definits a Weblate.

Nota

Això no defineix nous idiomes per a Weblate; només filtra els existents a la base de dades.

Exemple:

BASIC_LANGUAGES = {"cs", "it", "ja", "en"}

Vegeu també

Definicions del llenguatge

BORG_EXTRA_ARGS

Afegit a la versió 4.9.

Podeu passar arguments addicionals a borg create quan s’activin les còpies de seguretat integrades.

Exemple:

BORG_EXTRA_ARGS = ["--exclude", "vcs/"]

Vegeu també

CACHE_DIR

Afegit a la versió 4.16.

Directori on Weblate emmagatzema els fitxers de memòria cau. Per defecte a la subcarpeta cache a DATA_DIR.

Canvieu-ho a un sistema de fitxers local o temporal si DATA_DIR es troba en un sistema de fitxers de xarxa.

Weblate emmagatzema aquí els fitxers d’ajuda generats i n’executa alguns, de manera que CACHE_DIR s’ha de poder escriure i muntar en un sistema de fitxers que permeti l’execució. Eviteu utilitzar les opcions de muntatge noexec per a aquest directori.

El contenidor Docker utilitza un volum separat per a això, vegeu Volums de contenidors Docker.

Normalment existeixen els subdirectoris següents:

ssh

S’han generat fitxers d’ajuda utilitzats per a l’accés a VCS.

fonts

font-config memòria cau per a Gestió de tipus de lletra.

avatar

Cached user avatars, see Avatars.

static

Ubicació per defecte per als fitxers Django estàtics, especificada per STATIC_ROOT. Vegeu Donant arxius estàtics.

tesseract

OCR trained data for Screenshots and visual context.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC

Personalitzeu la capçalera Content-Security-Policy per a Weblate. La capçalera es genera automàticament a partir d’integracions habilitats amb serveis de tercers (Matomo, Google Analytics, Sentry, …).

Tots aquests per defecte són una llista buida.

Exemple:

# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]

Vegeu també

CHECK_LIST

Llista de controls de qualitat a realitzar en una traducció.

Nota

Proporcioneu un camí completament qualificat a la classe Python que implementa la interfície de verificació.

Ajusteu la llista de xecs per incloure-ne els que us corresponguin.

Tots els Controls de qualitat integrats estan activats per defecte, des d’on podeu canviar aquests paràmetres. Per defecte es comenten a Exemple de configuració de manera que s’utilitzen els valors predeterminats. A continuació, es realitzen noves comprovacions per a cada nova versió de Weblate.

Podeu desactivar tots els controls:

CHECK_LIST = ()

Només en podeu activar uns quants:

CHECK_LIST = (
    "weblate.checks.chars.BeginNewlineCheck",
    "weblate.checks.chars.EndNewlineCheck",
    "weblate.checks.chars.MaxLengthCheck",
)

Nota

Canviar aquesta configuració només afecta les traduccions que s’han canviat recentment. Les comprovacions existents encara s’emmagatzemaran a la base de dades. Per aplicar també canvis a les traduccions emmagatzemades, executeu updatechecks.

Vegeu també

COMMIT_PENDING_HOURS

Nombre d’hores entre que es cometen canvis pendents mitjançant la tasca en segon pla.

Vegeu també

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Afegit a la versió 5.17.1.

Configura la mida màxima, en bytes, per als fitxers ZIP de components carregats. Per defecte, 50 MB.

A Docker, configureu-ho amb la variable d’entorn WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE.

Vegeu també

CONTACT_FORM

Afegit a la versió 4.6.

Configura com s’envia el correu electrònic des del formulari de contacte. Trieu una configuració que coincideixi amb la del vostre servidor de correu.

"reply-to"

El remitent s’utilitza com a Reply-To, aquest és el comportament predeterminat.

"from"

The sender is used as From. Your mail server needs to allow sending such e-mails.

"disabled"

Desactiva completament el formulari de contacte.

Afegit a la versió 5.15.

Vegeu també

ADMINS_CONTACT

DATA_DIR

La carpeta Weblate emmagatzema totes les dades. Conté enllaços a repositoris VCS, un índex de text complet i diversos fitxers de configuració per a eines externes.

Normalment existeixen els subdirectoris següents:

home

Directori inicial utilitzat per invocar scripts.

ssh

Claus SSH i configuració.

media

Default location for Django media files, specified by MEDIA_ROOT. Contains uploaded screenshots, see Screenshots and visual context.

vcs

Version-control repositories for translations.

backups

Còpia de seguretat diària de dades. Si us plau, comproveu Dades bolcades per a còpies de seguretat per obtenir més informació.

fonts:

Tipus de lletra penjats per l’usuari, vegeu Gestió de tipus de lletra.

cache

Cachés diversos. Es pot col·locar en un altre lloc mitjançant CACHE_DIR.

El contenidor Docker utilitza un volum separat per a això, vegeu Volums de contenidors Docker.

Nota

Weblate ha de poder escriure aquest directori. Executar-lo com a WSGI significa que l’usuari de www-data hi hauria de tenir accés d’escriptura.

La manera més senzilla d’aconseguir-ho és convertir l’usuari en el propietari del directori:

sudo chown www-data:www-data -R $DATA_DIR

El valor per defecte és /home/weblate/data, però s’espera que estigui configurat.

Vegeu també

DATABASE_BACKUP

Si les còpies de seguretat de la base de dades s’han d’emmagatzemar com a text sense format, comprimir-se o ometre. Els valors autoritzats són:

  • "plain"

  • "compressed"

  • "none"

Vegeu també

Còpia de seguretat i moviment de Weblate

DEFAULT_ACCESS_CONTROL

La configuració predeterminada de control d’accés per a projectes nous:

0

Públic

1

Protegit

100

Privat

200

Personalitzat

Utilitzeu Personalitzat si esteu gestionant l’ACL manualment, el que significa no confiar en la gestió interna del Weblate.

Vegeu també

DEFAULT_AUTO_WATCH

Afegit a la versió 4.5.

Configura si Mira automàticament els projectes de contribució s’ha d’activar per als usuaris nous. El valor predeterminat és True.

Vegeu també

Notificacions

DEFAULT_RESTRICTED_COMPONENT

Afegit a la versió 4.1.

El valor predeterminat per a la restricció de components.

Vegeu també

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE

Missatges de confirmació per defecte per a diferents operacions, comproveu Configuració dels components per obtenir més informació.

Els valors predeterminats integrats segueixen els compromisos convencionals i inclouen enllaços Weblate quan estiguin disponibles. El canvi d’aquests paràmetres afecta els valors predeterminats recentment creats; les plantilles de missatges existents es poden restablir als formularis de configuració amb Restaura el lloc predeterminat. Per als valors heretats, la restauració del valor predeterminat del lloc també desactiva l’herència d’aquest missatge.

Vegeu també

DEFAULT_ADDONS

Complements predeterminats per instal·lar per a cada component creat.

Nota

Aquesta configuració només afecta els components de nova creació.

Exemple:

DEFAULT_ADDONS = {
    # Add-on with no parameters
    "weblate.flags.target_edit": {},
    # Add-on with parameters
    "weblate.autotranslate.autotranslate": {
        "mode": "suggest",
        "filter_type": "todo",
        "auto_source": "mt",
        "component": "",
        "engines": ["weblate-translation-memory"],
        "threshold": "80",
    },
}

Vegeu també

DEFAULT_COMMITER_EMAIL

Adreça de correu electrònic del Committer, per defecte noreply@weblate.org.

This identifies Weblate as the committer, separately from the translator recorded as the author. To make translators” author e-mail addresses private by default, set PRIVATE_COMMIT_EMAIL_OPT_IN to False.

Vegeu també

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME

Nom del committer, per defecte Weblate.

This identifies Weblate as the committer, separately from the translator recorded as the author. To make translators” author names private by default, set PRIVATE_COMMIT_NAME_OPT_IN to False.

Vegeu també

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE

Afegit a la versió 4.3.2.

Llengua d’origen for any new components.

El valor per defecte és «en». L’objecte de llenguatge coincident ha d’existir a la base de dades.

Vegeu també

DEFAULT_MERGE_STYLE

Estil de fusió for any new components.

  • rebase - default

  • fusionar

Vegeu també

DEFAULT_NOTIFICATIONS

Afegit a la versió 2026.10.1.

Default notification settings for every newly created user.

A list of 3-tuples consisting of notification scope, notification frequency and notification handler.

Scopes:

0

All

10

Watched

20

Administered

Frequencies:

0

No notification

1

Instant notification

2

Daily digest

3

Weekly digest

4

Monthly digest

Handlers:

ApprovedStringNotificaton

String was approved

ChangedStringNotificaton

String was changed

ComponentTranslatedNotificaton

Component was translated

LanguageTranslatedNotificaton

Language was translated

LastAuthorCommentNotificaton

String you contributed to received a comment

LicenseNotification

License was changed

LockNotification

Component was locked or unlocked

MentionCommentNotificaton

You were mentioned in a comment

MergeFailureNotification

Repository operation failed

NewAlertNotificaton

New alert emerged in a component

NewAnnouncementNotificaton

Announcement was published

NewCommentNotificaton

Comment was added

NewComponentNotificaton

New translation component was created

NewContributorNotificaton

Contributor made their first translation

NewStringNotificaton

String is available for translation

NewSuggestionNotificaton

Suggestion was added

NewTranslationNotificaton

New language was added or requested

ParseErrorNotification

Parse error occurred

PendingSuggestionsNotification

Pending suggestions exist

RepositoryNotification

Operation was performed in the repository

ToDoStringsNotification

Unfinished strings exist

TranslatedStringNotificaton

String was edited by user

TranslationActivitySummaryNotification

Translation activity summary

Nota

This setting affects only newly created users.

Exemple:

DEFAULT_NOTIFICATIONS = [
    (0, 1, "MentionCommentNotificaton"),
    (10, 1, "LastAuthorCommentNotificaton"),
]

Vegeu també

DEFAULT_SHARED_TM

Configura el valor per defecte de Utilitza la memòria de traducció compartida i Contribueix a la memòria de traducció compartida.

DEFAULT_TRANSLATION_REVIEW

Afegit a la versió 5.16.

Configura el valor predeterminat per a Activa les revisions, desactivat per defecte.

DEFAULT_SOURCE_REVIEW

Afegit a la versió 5.16.

Configura el valor predeterminat per a Activa les revisions d’origen, desactivat per defecte.

DEFAULT_AUTOCLEAN_TM

Afegit a la versió 5.13.

Configura el valor per defecte de Neteja automàticament la memòria de traducció.

DEFAULT_TRANSLATION_PROPAGATION

Configuració per defecte per a la propagació de la traducció, el valor predeterminat és True.

Vegeu també

DEFAULT_PULL_MESSAGE

Configura el títol i el missatge predeterminats per a les sol·licituds d’extracció.

El valor predeterminat integrat segueix els compromisos convencionals i inclou enllaços a Weblate i estat de traducció.

ENABLE_AVATARS

Si s’han d’activar els avatars basats en Gravatar per als usuaris. Activat per defecte.

Els avatars s’obtenen i s’emmagatzemen a la memòria cau al servidor, reduint el risc de filtrar informació privada i accelerar l’experiència de l’usuari.

Vegeu també

ENABLE_HOOKS

Whether to turn on anonymous remote hooks.

Vegeu també

Punts d’inserció de notificacions

ENABLE_HTTPS

Canviat a la versió 5.7: Weblate ara requereix https per al suport de WebAuthn.

Ja sigui per enviar enllaços a Weblate com a HTTPS o HTTP. Aquesta configuració afecta els correus electrònics enviats i els URL absoluts generats.

A la configuració predeterminada, també s’utilitza per a diversos paràmetres de Django relacionats amb HTTPS: habilita galetes segures, activa HSTS o activa la redirecció a una URL HTTPS.

La redirecció HTTPS pot ser problemàtica en alguns casos i podeu trobar un problema amb la redirecció infinita en cas que utilitzeu un servidor intermediari invers que fa una terminació SSL que no passa correctament les capçaleres del protocol a Django. Si us plau, modifiqueu la configuració del servidor intermediari invers per emetre capçaleres X-Forwarded-Proto o Forwarded o configureu SECURE_PROXY_SSL_HEADER perquè Django detecti correctament l’estat SSL.

En cas que estigui desactivat, Weblate no s’iniciarà amb un error otp_webauthn.E031. Podeu silenciar aquest error afegint-lo a SILENCED_SYSTEM_CHECKS, però encara WebAuthn no funcionarà per a llocs sense HTTPS.

Vegeu també

ENABLE_SHARING

Activa/desactiva el menú Comunitat perquè els usuaris puguin compartir el progrés de la traducció a les xarxes socials.

Vegeu també

Building the translation community

EXTRA_HTML_HEAD

Afegit a la versió 4.15.

Inseriu un marcatge addicional a la capçalera HTML. Es pot utilitzar per verificar la propietat del lloc, per exemple:

EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'

Avís

No es realitza cap desinfecció a la corda. S’insereix tal com està a la capçalera HTML.

GET_HELP_URL

Afegit a la versió 4.5.2.

URL on es pot trobar suport per a la vostra instància de Weblate.

GITEA_CREDENTIALS

Afegit a la versió 4.12.

Llista de credencials per als servidors de Gitea.

GITEA_CREDENTIALS = {
    "try.gitea.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

El diccionari de configuració consta de credencials definides per a cada host de l’API. El disseny és el mateix per a gairebé totes les integracions de control de versions i es descriu a Configuring version control credentials.

Vegeu també

GITLAB_CREDENTIALS

Afegit a la versió 4.3.

Llista de credencials per als servidors de GitLab.

GITLAB_CREDENTIALS = {
    "gitlab.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Nota

El testimoni d’accés personal necessita l’àmbit api per poder utilitzar l’API.

El diccionari de configuració consta de credencials definides per a cada host de l’API. El disseny és el mateix per a gairebé totes les integracions de control de versions i es descriu a Configuring version control credentials.

Vegeu també

GITHUB_CREDENTIALS

Afegit a la versió 4.3.

Llista de credencials per als servidors GitHub.

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

Nota

És possible utilitzar tant fitxes d’accés personals de gra fi com fitxes d’accés personals clàssiques. Els testimonis detallats es limiten a una única organització, de manera que no funcionarà si voleu que Weblate forqui un dipòsit fora de l’organització (normalment a l’espai de noms de l’usuari).

Per clonar, empènyer i crear sol·licituds d’extracció, cal l’accés de lectura i escriptura a Contents i Sol·licituds d’extracció.

Administració també pot ser necessària per bifurcar un repositori si voleu utilitzar la bifurcació i el repositori original no és públic.

Suggeriment

Utilitzeu api.github.com com a amfitrió de l’API per a https://github.com/.

El diccionari de configuració consta de credencials definides per a cada host de l’API. El disseny és el mateix per a gairebé totes les integracions de control de versions i es descriu a Configuring version control credentials.

Vegeu també

GITHUB_LEGACY_APP_WEBHOOK_SECRET

Afegit a la versió 2026.8.

Webhook secret for a legacy GitHub App which delivers events to the generic GitHub webhook URL, /hooks/github/.

App webhook deliveries to the generic URL are rejected when this setting is empty or their X-Hub-Signature-256 does not match. Ordinary repository webhooks are unaffected. GitHub Apps registered through Weblate use their per-App webhook URLs and do not use this setting.

GITHUB_LEGACY_APP_WEBHOOK_SECRET = "your-webhook-secret"

Vegeu també

BITBUCKETSERVER_CREDENTIALS

Afegit a la versió 4.16.

Llista de credencials per a Bitbucket Data Center.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-token",
    },
}

El diccionari de configuració consta de credencials definides per a cada host de l’API. El disseny és el mateix per a gairebé totes les integracions de control de versions i es descriu a Configuring version control credentials.

Vegeu també

BITBUCKETCLOUD_CREDENTIALS

Afegit a la versió 5.8.

Llista de credencials per als servidors Bitbucket Cloud.

BITBUCKETCLOUD_CREDENTIALS = {
    "bitbucket.org": {
        "username": "your-email",
        "workspace": "your-workspace-slug",
        "token": "your-api-token",
    },
}

El diccionari de configuració consta de credencials definides per a cada host de l’API. L’amfitrió de l’API pot ser diferent del que utilitzeu al navegador web, per exemple, s’accedeix a l’API de GitHub com a api.github.com.

The following configuration is available for each host:

username

API user.

workspace

El llimac de l’espai de treball de l’usuari.

token

El testimoni de l’API amb permís «pullrequest:write».

Es poden trobar paràmetres addicionals no descrits aquí a Configuring version control credentials.

Vegeu també

AZURE_DEVOPS_CREDENTIALS

Afegit a la versió 5.2.

Llista de credencials per als servidors Azure DevOps.

AZURE_DEVOPS_CREDENTIALS = {
    "dev.azure.com": {
        "username": "project-name",
        "token": "your-api-token",
        "organization": "organization-name",
    },
}

El diccionari de configuració consta de credencials definides per a cada host de l’API. L’amfitrió de l’API pot ser diferent del que utilitzeu al navegador web, per exemple, s’accedeix a l’API de GitHub com a api.github.com.

The following configuration is available for each host:

username

El nom del projecte Azure DevOps. Aquest no és el nom del repositori.

organization

The name of the organization of the project.

workItemIds

Una llista opcional d’identificadors d’elements de treball de la vostra organització. Quan es proporcionin, les noves sol·licituds d’extracció les tindran adjunts.

token

Es requereix un testimoni d’API per a l’usuari de l’API.

Es poden trobar paràmetres addicionals no descrits aquí a Configuring version control credentials.

Vegeu també

GOOGLE_ANALYTICS_ID

Identificador de Google Analytics per activar la supervisió de Weblate mitjançant Google Universal Analytics.

Nota

Actualment, la integració de Google Analytics 4 no està disponible per a Weblate; consulteu https://github.com/WeblateOrg/weblate/issues/14015.

HIDE_REPO_CREDENTIALS

Amaga les credencials del dipòsit des de la interfície web. En cas que tingueu una URL de repositori amb usuari i contrasenya, Weblate l’amagarà quan es mostri informació relacionada als usuaris.

Per exemple, en lloc de https://usuari:contrasenya@git.example.com/repo.git es mostrarà només https://git.example.com/repo.git. També intenta netejar els missatges d’error VCS d’una manera similar.

Nota

On by default.

VERSION_DISPLAY

Afegit a la versió 5.17.

Controla amb quina importància Weblate exposa la seva pròpia versió.

Supported values are:

show

Mostra la versió a la interfície d’usuari compartida, com ara el peu de pàgina i exposa-la a GET /api/metrics/.

soft

Amaga la versió de la interfície d’usuari compartida destacada, mantenint-la visible a la pàgina Quant a i a GET /api/metrics/.

hide

Amaga la versió de la interfície d’usuari compartida i GET /api/metrics/. Això també fa que els enllaços de documentació anònims apuntin a la documentació més recent en lloc de la versió que coincideix amb la versió instal·lada.

Amagar la versió és una pràctica de seguretat recomanada en algunes corporacions, però no impedeix que un atacant dedueixi la versió investigant el comportament.

Nota

The default is show.

HIDE_VERSION

Afegit a la versió 4.3.1.

Obsolet des de la versió 5.17.

Àlies de compatibilitat per a VERSION_DISPLAY. Estableix-ho a True per obtenir el mateix comportament que VERSION_DISPLAY = "amagar".

INTERNAL_BOT_EMAIL_TEMPLATE

Afegit a la versió 2026.7.1.

Template used to generate e-mail addresses for internal Weblate bot accounts. Defaults to "noreply-{scope}-{name}@weblate.org".

It can contain {scope}, {name}, {username}, {site_title}, and {site_domain}.

Use {scope} and {name} when generating the e-mail local part. The {username} value contains the internal scope:name username.

Existing internal bot accounts are updated when migrate is run. Project API token accounts are not affected.

IP_BEHIND_REVERSE_PROXY

Indica si Weblate s’està executant darrere d’un servidor intermediari invers.

Si s’estableix en True, Weblate obté l’adreça IP d’una capçalera definida per IP_PROXY_HEADER.

Avís

The reverse proxy which connects to Weblate must overwrite the configured header or append a verified peer address at the position selected by IP_PROXY_OFFSET. Weblate does not verify which peer supplied the header, so trusting a client-controlled value allows IP address spoofing.

Ensure that untrusted clients cannot reach Weblate without passing through the trusted proxy.

Nota

Això no està activat per defecte.

Vegeu també

IP_PROXY_HEADER

Indica de quina capçalera Weblate hauria d’obtenir l’adreça IP quan IP_BEHIND_REVERSE_PROXY estigui activat.

El valor per defecte és HTTP_X_FORWARDED_FOR.

Vegeu també

IP_PROXY_OFFSET

Canviat a la versió 5.0.1: The default changed from 1 to -1.

Indica quina part de IP_PROXY_HEADER s’utilitza com a adreça IP del client.

Depenent de la vostra configuració, aquesta capçalera pot consistir en diverses adreces IP, (per exemple, X-Forwarded-For: client-ip, proxy-a, proxy-b) i podeu configurar quina adreça de la capçalera s’utilitza com a adreça IP del client aquí.

Avís

Setting this affects the security of your installation. Select only an address added or verified by a proxy under your control. Addresses supplied by the client are untrusted. Ensure that the selected offset matches how your proxies construct the header.

See <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> for more details.

Defaults to -1.

Vegeu també

LICENSE_EXTRA

Llicències addicionals per incloure a les opcions de llicència.

Nota

Cada definició de llicència ha de ser una tupla del seu nom curt, un nom llarg, un URL i un booleà, que indica si és una llicència lliure.

Per exemple:

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
        True,
    ),
]

LICENSE_FILTER

Canviat a la versió 4.3: Si estableix-ho com a valor en blanc, ara desactiva l’alerta de llicència.

Filtreu la llista de llicències per mostrar. Això també desactiva l’alerta de llicència quan es defineix com a buida.

Nota

Aquest filtre utilitza els noms de llicència curts.

Per exemple:

LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}

A continuació, es desactiva l’alerta de llicència:

LICENSE_FILTER = set()

Vegeu també

Translation component diagnostics

LICENSE_REQUIRED

Defineix si l’atribut de llicència a Configuració dels components és necessari.

Nota

Això està desactivat per defecte.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH

Si la durada d’una traducció determinada s’ha de limitar. La restricció és la longitud de la cadena d’origen × 10 caràcters.

Suggeriment

Establiu-ho a False per permetre traduccions més llargues (fins a 10.000 caràcters) independentment de la longitud de la cadena d’origen.

Nota

El valor predeterminat és True.

LOCALIZE_CDN_URL i LOCALIZE_CDN_PATH

These settings configure the CDN add-ons, including CDN de localització de JavaScript, Translation files CDN, and Kotlin SDK CDN. LOCALIZE_CDN_URL defines root URL where the localization CDN is available and LOCALIZE_CDN_PATH defines path where Weblate should store generated files which will be served at the LOCALIZE_CDN_URL. The files are served by your web server or CDN, not by Weblate; see Localization CDN for secure serving guidance.

Suggeriment

A Hosted Weblate, això fa servir https://weblate-cdn.com/.

Vegeu també

MATOMO_SITE_ID

Identificador del lloc a Matomo (abans Piwik) que voleu utilitzar per fer el seguiment de Weblate.

Nota

Aquesta integració no és compatible amb Matomo Tag Manager.

Vegeu també

MATOMO_URL

MATOMO_URL

URL complet (inclosa la barra inclinada) d’una instal·lació de Matomo (abans Piwik) que voleu utilitzar per fer un seguiment de l’ús de Weblate. Si us plau, comproveu <https://matomo.org/> per obtenir més detalls.

Suggeriment

Aquesta integració no és compatible amb Matomo Tag Manager.

Per exemple:

MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"

Vegeu també

MATOMO_SITE_ID

NEARBY_MESSAGES

Nombre de cadenes properes que es mostraran en cada direcció a l’editor complet.

This is just a default value, users can adjust this in Perfil d’usuari.

DEFAULT_PAGE_LIMIT

Afegit a la versió 4.7.

Nombre d’elements per defecte a mostrar quan la paginació està activa.

PAGURE_CREDENTIALS

Afegit a la versió 4.3.2.

Llista de credencials per als servidors de Pagure.

PAGURE_CREDENTIALS = {
    "pagure.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

El diccionari de configuració consta de credencials definides per a cada host de l’API. El disseny és el mateix per a gairebé totes les integracions de control de versions i es descriu a Configuring version control credentials.

Vegeu també

PASSWORD_MINIMAL_STRENGTH

Afegit a la versió 5.10.2.

Puntuació mínima de la contrasenya avaluada per l’estimador de seguretat de la contrasenya zxcvbn.

El valor predeterminat és 0, el que significa que la comprovació de la força està desactivada.

Vegeu també

PASSWORD_RESET_URL

Afegit a la versió 5.17.

URL per a la restabliment de la contrasenya quan l’autenticació la gestiona un proveïdor d’identitat extern, com ara LDAP, SAML o OAuth.

Quan s’estableix, Has oblidat la teva contrasenya? a la pàgina d’inici de sessió enllaça a aquest URL en lloc de la pàgina de restabliment de la contrasenya integrada de Weblate.

PRIVACY_URL

Afegit a la versió 4.8.1.

URL on la vostra instància de Weblate mostra la seva política de privadesa.

Suggeriment

When the Legal module module is enabled, this URL takes priority over its internal privacy page in document links. The default privacy template links to this URL when visited directly.

Exemple:

PRIVACY_URL = "https://weblate.org/terms/"

Vegeu també

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN

Afegit a la versió 4.15.

Configures whether the private commit e-mail is opt-in or opt-out.

With True (the default), users use their account e-mail unless they choose a private commit e-mail. Set to False to use PRIVATE_COMMIT_EMAIL_TEMPLATE by default.

Suggeriment

This setting applies to new and existing users who have not explicitly chosen a commit e-mail. Users can still choose their account e-mail in the Compte settings. Bot accounts do not use the private default.

Vegeu també

PRIVATE_COMMIT_EMAIL_TEMPLATE

Afegit a la versió 4.15.

Plantilla per generar un correu electrònic de confirmació privat per a un usuari. El valor predeterminat és "{username}@users.noreply.{site_domain}".

Pot contenir {user_id}, {username}, {site_title} i {site_domain}.

Set to a blank string to disable private commit e-mails and use the account e-mail when no commit e-mail has been explicitly chosen.

The default template includes the username. To avoid including it, use "user-{user_id}@users.noreply.{site_domain}" instead. Changing the template alone does not make private commit e-mails the default.

Nota

Using a different commit e-mail is opt-in for users unless configured by PRIVATE_COMMIT_EMAIL_OPT_IN. Users can configure their commit e-mail in the Public profile.

PRIVATE_COMMIT_NAME_OPT_IN

Afegit a la versió 5.16.

Configures whether the private commit name is opt-in or opt-out.

With True (the default), users use their account name unless they choose a private commit name. Set to False to use PRIVATE_COMMIT_NAME_TEMPLATE by default.

Suggeriment

This setting applies to new and existing users who have not explicitly chosen a commit name. Users can still choose their account name in the Compte settings. Bot accounts use their account name.

Vegeu també

PRIVATE_COMMIT_NAME_TEMPLATE

Afegit a la versió 5.16.

Plantilla per generar un nom de commit privat per a un usuari. El valor per defecte és "{site_title} usuari {user_id}".

Pot contenir {user_id}, {username}, {site_title} i {site_domain}.

Set to a blank string to disable private commit names and use the account name. Changing the template alone does not make private commit names the default.

Nota

Using a different commit name is opt-in for users unless configured by PRIVATE_COMMIT_NAME_OPT_IN. Users can configure their commit name in the Public profile.

PROJECT_BACKUP_KEEP_COUNT

Afegit a la versió 4.14.

Defineix quantes còpies de seguretat per projecte es conserven al servidor. Per defecte, 3.

Vegeu també

Project level backups

PROJECT_BACKUP_KEEP_DAYS

Afegit a la versió 4.14.

Defineix quant de temps es mantindran les còpies de seguretat del projecte al servidor. Per defecte, 30 dies.

Vegeu també

Project level backups

PROJECT_BACKUP_UPLOAD_MAX_SIZE

Afegit a la versió 5.17.1.

Configura la mida màxima, en bytes, per als fitxers ZIP de còpia de seguretat del projecte carregats. Per defecte, 536870912 bytes (512 MiB).

A Docker, configureu-ho amb la variable d’entorn WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE. Les configuracions de Docker també es poden limitar per CLIENT_MAX_BODY_SIZE; altres desplegaments poden estar restringits pel seu límit de mida corporal de sol·licitud de proxy inversa.

Vegeu també

Project level backups

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Afegit a la versió 5.17.

Defineix el nombre màxim d’entrades ZIP permeses en importar una còpia de seguretat del projecte.

Aquesta és una salvaguarda contra arxius mal formats o fragmentats intencionadament. Per defecte, 100.000 entrades.

A Docker, configureu-ho amb la variable d’entorn WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS.

Vegeu també

Project level backups

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE

Afegit a la versió 5.17.1.

Defineix la mida màxima total sense comprimir, en bytes, per a les entrades ZIP en una còpia de seguretat del projecte importada. Per defecte, 536870912 bytes (512 MiB).

Això limita els arxius que són petits quan es pengen, però que s’amplien a moltes més dades durant la validació o la restauració.

A Docker, configureu-ho amb la variable d’entorn WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE.

Vegeu també

Project level backups

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Afegit a la versió 5.17.

Defineix la mida màxima sense comprimir, en bytes, per a una única entrada ZIP altament comprimida en una còpia de seguretat del projecte importada.

Aquest límit només s’aplica a les entrades prou grans i comprimides prou com per semblar sospitoses. Els fitxers grans de baixa compressió es permeten intencionadament aquí i s’espera que estiguin limitats pel límit de càrrega HTTP. Per defecte, 262144000 bytes (250 MiB).

A Docker, configureu-ho amb la variable d’entorn WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE.

Vegeu també

Project level backups

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Afegit a la versió 5.17.

Defineix la mida mínima sense comprimir, en bytes, a la qual Weblate comença a considerar la relació de compressió ZIP durant la importació de la còpia de seguretat del projecte.

Els fitxers més petits s’ignoren per a la validació basada en la relació de compressió per evitar rebutjar fitxers de mida raonable que es comprimeixen bé. Per defecte, 1048576 bytes (1 MiB).

A Docker, configureu-ho amb la variable d’entorn WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE.

Vegeu també

Project level backups

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Afegit a la versió 5.17.

Defineix la relació màxima permesa entre la mida sense comprimir i la comprimida per a una entrada ZIP gran durant la importació de la còpia de seguretat del projecte.

Això s’utilitza juntament amb PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE i PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE per detectar entrades sospitosament comprimides, alhora que permeten fitxers de paquets de dipòsit grans i altres continguts de baixa compressió. El valor predeterminat és 250.

A Docker, configureu-ho amb la variable d’entorn WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO.

Vegeu també

Project level backups

PROJECT_NAME_RESTRICT_RE

Afegit a la versió 4.15.

Defineix una expressió regular per restringir la denominació del projecte. Tots els noms coincidents seran rebutjats.

Vegeu també

Nom del projecte

PROJECT_WEB_RESTRICT_HOST

Afegit a la versió 4.16.2.

Rebutja l’ús de determinats amfitrions al lloc web del projecte. Qualsevol subdomini coincideix, de manera que incloure example.com també bloquejarà test.example.com. La llista només ha de contenir cadenes en minúscules, el domini analitzat és en minúscules abans de coincidir.

Default configuration:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

Vegeu també

PROJECT_WEB_RESTRICT_ALLOWLIST

Afegit a la versió 5.17.

Defineix un conjunt de slugs de projecte exempts de PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE i PROJECT_WEB_RESTRICT_RE en validar el lloc web del projecte. Els llimacs del projecte es combinen sense distinció de majúscules i minúscules.

Compte

Aquesta exempció debilita les proteccions d’URL de sortida per als projectes coincidents, inclosa la restricció d’objectius privats aplicada per PROJECT_WEB_RESTRICT_PRIVATE. Utilitzeu-lo només per a projectes de confiança i gestionats per l’administrador en què no és intencionat passar per alt aquestes comprovacions.

Default configuration:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

Vegeu també

PROJECT_WEB_RESTRICT_NUMERIC

Afegit a la versió 4.16.2.

Rebutja l’ús de l’adreça IP numèrica al lloc web del projecte. Activat per defecte.

Vegeu també

PROJECT_WEB_RESTRICT_PRIVATE

Afegit a la versió 5.17.

Rebutja l’ús d’URL del lloc web del projecte i del navegador del dipòsit que apunten a adreces internes o no públiques. Activat per defecte.

Vegeu també

PROJECT_WEB_RESTRICT_RE

Afegit a la versió 4.15.

Defines a regular expression to limit what can be entered as Lloc web del projecte. Any matching URLs will be rejected.

Vegeu també

WEBHOOK_PRIVATE_ALLOWLIST

Afegit a la versió 5.17.

Defineix noms d’amfitrió o dominis exempts de WEBHOOK_RESTRICT_PRIVATE per al lliurament de webhook de sortida. Les entrades segueixen la semàntica de concordança de l’amfitrió de Django, de manera que es poden utilitzar valors com ara hooks.internal.example o .internal.example.

Default configuration:

WEBHOOK_PRIVATE_ALLOWLIST = []

Vegeu també

WEBHOOK_RESTRICT_PRIVATE

Afegit a la versió 5.17.

Rebutja els URL de webhook que apunten a adreces internes o no públiques tret que l’amfitrió de destinació estigui inclòs a WEBHOOK_PRIVATE_ALLOWLIST. Activat per defecte.

Quan està activat, els noms d’amfitrió que no es poden resoldre durant la validació es rebutgen tret que s’incloguin explícitament a WEBHOOK_PRIVATE_ALLOWLIST.

Vegeu també

PUBLIC_ENGAGE

Afegit a la versió 5.16.2.

Permet la participació pública fins i tot amb REQUIRE_LOGIN.

Vegeu també

REPORT_EXPIRY

Defines how many days generated translation reports are retained. Defaults to 90 days. Changing the value also changes when existing reports become eligible for removal by the daily cleanup task.

RATELIMIT_NOTIFICATION_LIMITS

Afegit a la versió 5.14.

Limita el nombre de notificacions que s’enviaran per a un sol usuari.

The default setting is:

# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
    # Prevent burst sends - 3 emails per 2 minutes
    (3, 120),
    # Equalize to avoid getting blocked for too long - 10 emails per hour
    (10, 3600),
    # Daily limit: 50 emails per day
    (50, 86400),
]

API_RATELIMIT_ANON

Afegit a la versió 2026.10.

Default anonymous API rate limit. Defaults to "100/day". Rates use a request count and a period of seconds, minutes, hours, or days, for example "100/hour". A zero count rejects every request covered by this throttle; None disables this throttle. Anonymous requests without an IP override are also subject to API_RATELIMIT_USER.

API_RATELIMIT_USER

Afegit a la versió 2026.10.

Default authenticated API rate limit. Defaults to "5000/hour". Uses the same rate syntax as API_RATELIMIT_ANON. Authenticated requests are counted per user; anonymous requests are counted per client IP. Set None to disable this throttle.

API_RATELIMIT_USER_OVERRIDES

Afegit a la versió 2026.10.

Mapping of exact usernames to API rate limits. Defaults to an empty dictionary. Override rates require a positive request count, or None for an exemption. These rules take precedence over API_RATELIMIT_IP_OVERRIDES.

API_RATELIMIT_USER_OVERRIDES = {"automation": "20000/hour"}

API_RATELIMIT_IP_OVERRIDES

Afegit a la versió 2026.10.

Mapping of IPv4 or IPv6 addresses and CIDR networks to API rate limits. Defaults to an empty dictionary. The most specific matching network applies to both anonymous and authenticated requests, unless a username override matches. CIDRs must specify network addresses; duplicate normalized networks are rejected. Override rates require a positive request count, or None for an exemption.

API_RATELIMIT_IP_OVERRIDES = {
    "192.0.2.42": None,
    "198.51.100.0/24": "10000/hour",
    "2001:db8::/48": "10000/hour",
}

See Limitació de velocitat de l’API for counting behavior and trusted proxy requirements.

RATELIMIT_ATTEMPTS

Nombre màxim d’intents d’autenticació abans que s’apliqui la limitació de velocitat.

El valor per defecte és 5.

Vegeu també

RATELIMIT_WINDOW

Quant de temps s’accepta l’autenticació després que s’apliqui la limitació de tarifa.

Una quantitat de segons, per defecte 300 (5 minuts).

Vegeu també

RATELIMIT_LOCKOUT

Quant de temps està bloquejada l’autenticació després que s’apliqui la limitació de velocitat.

Una quantitat de segons predeterminada a 600 (10 minuts).

Vegeu també

REGISTRATION_ALLOW_BACKENDS

Afegit a la versió 4.1.

Llista de backends d’autenticació des dels quals permetre el registre. Això només limita els nous registres, els usuaris encara poden autenticar-se i afegir autenticació mitjançant tots els backends d’autenticació configurats.

Es recomana mantenir activat REGISTRATION_OPEN mentre es limiten els backends de registre, en cas contrari els usuaris es podran registrar, però Weblate no mostrarà enllaços per registrar-se a la interfície d’usuari.

Exemple:

REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]

Suggeriment

Els noms del backend coincideixen amb els noms utilitzats a l’URL per a l’autenticació.

Vegeu també

REGISTRATION_CAPTCHA

Si el registre de comptes nous està protegit per un CAPTCHA. S’ha activat per defecte.

Si està activat, s’afegeix un CAPTCHA a totes les pàgines on un usuari introdueix la seva adreça de correu electrònic:

  • Registre de compte nou.

  • Recuperació de contrasenya.

  • Afegir correu electrònic a un compte.

  • Formulari de contacte per als usuaris que no han iniciat sessió.

Actualment, la protecció consta dels següents passos:

REGISTRATION_EMAIL_MATCH

Us permet filtrar quines adreces de correu electrònic es poden registrar.

El valor per defecte és .*, que permet registrar qualsevol adreça de correu electrònic.

Podeu utilitzar-lo per restringir el registre a un únic domini de correu electrònic:

REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"

REGISTRATION_ALLOW_DISPOSABLE_EMAILS

Afegit a la versió 5.16.1.

Permet el registre amb dominis de correu electrònic d’un sol ús. Quan està activat, la llista de bloqueig de dominis d’un sol ús s’omet. El valor per defecte és False.

Vegeu també

REGISTRATION_OPEN

Si actualment es permet el registre de comptes nous. S’ha activat per defecte.

Aquesta configuració afecta l’autenticació integrada per adreça de correu electrònic o mitjançant l’autenticació social de Python (podeu permetre determinats backends utilitzant REGISTRATION_ALLOW_BACKENDS).

Nota

Si utilitzeu mètodes d’autenticació de tercers com ara Autenticació LDAP, només amaga el formulari de registre, però és possible que els usuaris nous puguin iniciar sessió i crear comptes.

Vegeu també

REGISTRATION_REBIND

Afegit a la versió 4.16.

Permet tornar a vincular backends d’autenticació per als usuaris existents. Activeu-ho quan feu la migració entre proveïdors d’autenticació.

Nota

Desactivat per defecte per no permetre afegir altres backends d’autenticació a un compte existent. La tornada a vincular pot comportar un compromís del compte quan s’utilitzen més backends d’autenticació de tercers.

REPOSITORY_ALERT_THRESHOLD

Afegit a la versió 4.0.2.

Llindar per activar una alerta per als dipòsits obsolets o els que contenen massa canvis. El valor per defecte és 25.

Vegeu també

Translation component diagnostics

REQUIRE_LOGIN

Afegit a la versió 4.1.

Això habilita django.contrib.auth.middleware.LoginRequiredMiddleware i configura el marc REST per requerir l’autenticació per a tots els punts finals de l’API.

Canviat a la versió 5.15: Weblate ara es basa en el programari intermedi integrat de Django.

Nota

Això s’implementa a la Exemple de configuració. Per a Docker, utilitzeu WEBLATE_REQUIRE_LOGIN.

GOOGLE_CLOUD_ERROR_REPORTING

Configuration for Recollida d’informes d’errors i seguiment del rendiment using Google Cloud Error Reporting. Set to None to disable the integration, or set to a dictionary of keyword arguments for the Google Cloud Error Reporting client.

Weblate proporciona automàticament servei com a weblate i versió com a versió actual de Weblate o revisió de Git. Els valors explícits del diccionari anul·len aquests valors predeterminats.

OPENTELEMETRY_ENABLED

Afegit a la versió 2026.6.

Habiliteu el seguiment del backend mitjançant OpenTelemetry. Desactivat per defecte.

Les traces només s’exporten quan això està habilitat i està configurat OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT.

OPENTELEMETRY_EXPORTER_OTLP_ENDPOINT

Punt final de traces HTTP OTLP per a OpenTelemetry, per exemple https://collector.example.com/v1/traces.

OPENTELEMETRY_EXPORTER_OTLP_HEADERS

Capçaleres HTTP addicionals per a l’exportador OTLP d’OpenTelemetry. Per defecte, un diccionari buit.

OPENTELEMETRY_EXTRA_RESOURCE_ATTRIBUTES

Atributs addicionals de recursos d’OpenTelemetry. Per defecte, un diccionari buit.

OPENTELEMETRY_SERVICE_NAME

Nom del servei OpenTelemetry. El valor predeterminat és weblate.

OPENTELEMETRY_TRACES_SAMPLE_RATE

Configureu la freqüència de mostreig per a les traces d’OpenTelemetry. S’estableix a 1 per rastrejar tots els esdeveniments, 0 (el valor predeterminat) desactiva el seguiment.

SENTRY_DSN

Sentry DSN to use for Recollida d’informes d’errors i seguiment del rendiment.

Vegeu també

Integració de Django per a Sentry

SENTRY_ENVIRONMENT

Configura l’entorn per a Sentry. El valor predeterminat és devel.

SENTRY_MONITOR_BEAT_TASKS

Afegit a la versió 5.13.

Configureu si voleu supervisar les tasques de Celery Beat amb Sentry. El valor predeterminat és True.

SENTRY_PROFILES_SAMPLE_RATE

Configureu la freqüència de mostreig per al seguiment del rendiment. Establiu a 1 per perfilar tots els esdeveniments rastrejats (el valor predeterminat), 0 desactiva el perfil.

Vegeu també

Supervisió del rendiment de Sentry

SENTRY_SEND_PII

Permet a Sentry recopilar determinada informació d’identificació personal. Desactivat per defecte.

Canviat a la versió 5.7: This is turned off by default now, used to be turned on by default.

SENTRY_TRACES_SAMPLE_RATE

Configureu la freqüència de mostreig per al seguiment de perfils. S’estableix a 1 per rastrejar tots els esdeveniments, 0 (el valor predeterminat) desactiva el seguiment.

Vegeu també

Sentry Profiling

SIMPLIFY_LANGUAGES

Utilitzeu codis d’idioma senzills per a les combinacions d’idioma/país predeterminades. Per exemple, una traducció fr_FR utilitzarà el codi d’idioma fr. Aquest és normalment el comportament desitjat, ja que simplifica la llista d’idiomes per a aquestes combinacions predeterminades.

Desactiveu-ho si voleu fer traduccions diferents per a cada variant.

HIDE_SHARED_GLOSSARY_COMPONENTS

Afegit a la versió 5.16.

Els components del glossari normalment es comparteixen en altres projectes per posar-los a disposició per al treball de traducció. Quan aquests són visibles a la llista de components dels projectes que els fan servir, pot causar confusió o distreure els traductors dels components reals que s’han de traduir.

This is turned off by default, making shared glossary components visible.

SITE_DOMAIN

Configura el domini del lloc. Necessari per produir enllaços absoluts correctes en molts àmbits (per exemple, correus electrònics d’activació, notificacions o fonts RSS).

Si Weblate s’executa en un port no estàndard, incloeu-lo també aquí.

Exemples:

# Production site with domain name
SITE_DOMAIN = "weblate.example.com"

# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"

Nota

Aquesta configuració només hauria de contenir el nom del domini. Per configurar el protocol, (activar i fer complir HTTPS) utilitzeu ENABLE_HTTPS i per canviar l’URL, utilitzeu URL_PREFIX.

Suggeriment

En un contenidor Docker, el domini del lloc es configura mitjançant WEBLATE_ALLOWED_HOSTS.

Vegeu també

SITE_TITLE

Títol del lloc que s’utilitzarà per al lloc web i enviament de correus electrònics.

SPECIAL_CHARS

Caràcters addicionals per incloure al teclat visual, Teclat visual.

El valor per defecte és:

SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")

SINGLE_PROJECT

Redirigeix els usuaris directament a un projecte o component en lloc de mostrar el tauler. Podeu configurar-lo a True, de manera que només funcioni si en realitat només hi ha un projecte únic a Weblate. Alternativament, configureu el slug del projecte i es redirigirà incondicionalment a aquest projecte.

Exemple:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS

Afegit a la versió 4.9.

Permet afegir paràmetres personalitzats quan Weblate invoca SSH. Útil quan us connecteu a servidors amb xifratge heretat o altres funcions no estàndard.

Per exemple, quan la connexió SSH a Weblate falla amb No es pot negociar amb legacyhost: no s’ha trobat cap mètode d’intercanvi de claus coincident. La seva oferta: diffie-hellman-group1-sha1, podeu activar-ho utilitzant:

SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"

Suggeriment

La cadena és avaluada per l’intèrpret d’ordres, així que assegureu-vos que els espais en blanc i els caràcters especials estiguin entre cometes.

Avís

This is trusted administrator-controlled configuration. Arbitrary SSH options can alter connection routing and override the address pinning provided by VCS_RESTRICT_PRIVATE. Administrators are responsible for the security and compatibility impact of all configured arguments.

Vegeu també

Opcions heretades d’OpenSSH

STATUS_URL

L’URL on la vostra instància de Weblate informa del seu estat.

SUPPORT_STATUS_CHECK

Afegit a la versió 5.5.

Defaults to True. When enabled, superusers without integrated support are redirected after login to a page offering professional support, at most once every 180 days per account. The reminder starts once the installation has a change older than 14 days and waits for an HTML page navigation. A Continue to Weblate action returns to the intended page.

Set this to False to disable the redirect. This does not hide support or donation links elsewhere in the interface.

Suggeriment

Milloreu la vostra experiència de Weblate comprant una subscripció d’assistència i augmentant el progrés de Weblate en lloc de desactivar-ho.

TRANSLATION_UPLOAD_MAX_SIZE

Afegit a la versió 5.17.1.

Configura la mida màxima, en bytes, per als fitxers de traducció penjats. Per defecte, 50 MB.

A Docker, configureu-ho amb la variable d’entorn WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.

UNUSED_ALERT_DAYS

Afegit a la versió 4.17.

Es configura quan s’activa l’alerta El component no s’utilitza.

El valor predeterminat és 365 dies, s’estableix en 0 per desactivar-lo.

UPDATE_LANGUAGES

Afegit a la versió 4.3.2.

Controla si la base de dades d’idiomes s’ha d’actualitzar quan s’executa la migració de la base de dades i està activada de manera predeterminada. Aquesta configuració no té cap efecte en la invocació de setuplang.

Avís

La visualització d’idiomes pot ser incoherent amb això. Les definicions d’idiomes del weblate s’amplien amb el temps i no mostrarà el codi d’idioma per als idiomes definits.

Vegeu també

Built-in language definitions

URL_PREFIX

Aquesta configuració us permet executar Weblate sota algun camí (en cas contrari, depèn de ser executat des de l’arrel del servidor web).

Nota

Per utilitzar aquesta configuració, també heu de configurar el vostre servidor per eliminar aquest prefix. Per exemple amb WSGI, això es pot aconseguir establint WSGIScriptAlias.

Suggeriment

El prefix hauria de començar amb un /.

Exemple:

URL_PREFIX = "/translations"

Nota

Aquesta configuració no funciona amb el servidor integrat de Django, haureu d’ajustar urls.py perquè contingui aquest prefix.

VCS_ALLOW_HOSTS

Afegit a la versió 5.15.

Un conjunt d’amfitrions per permetre quan es configura l’URL de VCS. Per defecte, un conjunt buit, que no fa cap filtratge.

When VCS_RESTRICT_PRIVATE is enabled, matching hosts are also exempt from the private-target restriction. This exemption is also needed for VCS backends which cannot bind the client connection to the address validated by Weblate, such as Mercurial and Subversion.

Use VCS_PRIVATE_ALLOWLIST instead when hosts should be exempt from the private-target restriction without filtering access to other public hosts.

VCS_PRIVATE_ALLOWLIST

Afegit a la versió 2026.9.

Defines hostnames or domains exempt from VCS_RESTRICT_PRIVATE. Unlike VCS_ALLOW_HOSTS, this setting does not filter access to other hosts. Entries follow Django host matching semantics, so values such as vcs.internal.example or .internal.example can be used.

The exemption is needed for VCS backends which cannot bind the client connection to the address validated by Weblate, such as Mercurial and Subversion. It can also be used to allow private Git repository hosts.

When VCS_ALLOW_HOSTS is non-empty, its host filter still applies and takes precedence over this allowlist.

Default configuration:

VCS_PRIVATE_ALLOWLIST = []

Vegeu també

VCS_ALLOW_SCHEMES

Afegit a la versió 5.15.

Un conjunt d’esquemes d’URL per permetre quan es configura l’URL VCS. Només https i ssh es permeten per defecte.

The file scheme and bare filesystem paths are disabled for security reasons because they could allow component editors to access repositories on the server filesystem. Including file in this setting prevents Weblate from starting with an ImproperlyConfigured error.

VCS_RESTRICT_PRIVATE

Afegit a la versió 5.17.

Reject VCS repository URLs pointing to internal or non-public addresses unless the target host is included in VCS_ALLOW_HOSTS or matches VCS_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are trusted by VCS_ALLOW_HOSTS or VCS_PRIVATE_ALLOWLIST.

For Git repositories accessed over HTTPS or SSH, Weblate binds each VCS command to the addresses approved during runtime validation for direct connections. Configured HTTP proxies are trusted infrastructure and resolve repository hostnames instead. Automatic redirect following remains disabled. Permanent same-host HTTP redirects are probed separately through the same outbound route, validated, and stored as the canonical component repository URL. Cross-host redirects have to be configured manually. Mercurial, Subversion, custom VCS backends, and additional URL schemes are rejected unless the target host is trusted by VCS_ALLOW_HOSTS or VCS_PRIVATE_ALLOWLIST.

Network-level egress filtering which blocks internal, loopback, link-local, reserved, and cloud metadata address ranges is recommended as defense in depth, especially for custom integrations and administrator-installed extensions.

VCS_API_DELAY

Afegit a la versió 4.15.1.

Configures minimal delay in seconds between third-party API calls in GitHub pull requests, GitLab merge requests, Gitea pull requests, Pagure merge requests, and Azure DevOps pull requests.

Aquesta tarifa limita les trucades de l’API de Weblate a aquests serveis per evitar sobrecarregar-les.

Si us limita el limitador de velocitat secundari a GitHub, augmentar-ho pot ajudar.

El valor predeterminat és 10.

VCS_API_TIMEOUT

Afegit a la versió 5.15.

Configures timeout in seconds for third-party API calls such as forking or creating merge requests in GitHub pull requests, GitLab merge requests, Gitea pull requests, Pagure merge requests, and Azure DevOps pull requests.

El valor predeterminat és 10.

VCS_BACKENDS

Configuració dels backends VCS disponibles.

Nota

Weblate offers configured backends when their required commands are available. Exact command versions are validated by the deployment and periodic configuration health checks.

Suggeriment

Podeu limitar les opcions o afegir back-ends VCS personalitzats fent servir això.

VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)

Vegeu també

Integració del control de versions

VCS_CLONE_DEPTH

Configura la profunditat de la clonació dels dipòsits Weblate.

Nota

Currently this is only supported in Git. By default Weblate does shallow clones of the repositories to make cloning faster and save disk space. Depending on your usage (for example when using custom Complements), you might want to increase the depth or turn off shallow clones completely by setting this to 0.

Suggeriment

In case you get fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' error when pushing from Weblate, turn off shallow clones completely by setting:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS

Llista de complements disponibles per al seu ús. Per utilitzar-los, s’han d’habilitar per a un component de traducció determinat. De manera predeterminada, inclou tots els complements integrats, en ampliar la llista probablement voldreu mantenir activats els existents, per exemple:

WEBLATE_ADDONS = (
    # Built-in add-ons
    "weblate.addons.gettext.GenerateMoAddon",
    "weblate.addons.gettext.UpdateLinguasAddon",
    "weblate.addons.gettext.UpdateConfigureAddon",
    "weblate.addons.gettext.MsgmergeAddon",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LanguageConsistencyAddon",
    "weblate.addons.discovery.DiscoveryAddon",
    "weblate.addons.flags.SourceEditAddon",
    "weblate.addons.flags.TargetEditAddon",
    "weblate.addons.flags.SameEditAddon",
    "weblate.addons.flags.BulkEditAddon",
    "weblate.addons.generate.GenerateFileAddon",
    "weblate.addons.properties.PropertiesSortAddon",
    "weblate.addons.git.GitSquashAddon",
    "weblate.addons.removal.RemoveComments",
    "weblate.addons.removal.RemoveSuggestions",
    "weblate.addons.resx.ResxUpdateAddon",
    "weblate.addons.autotranslate.AutoTranslateAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

Nota

L’eliminació del complement de la llista no el desinstal·la dels components. Weblate es bloquejarà en aquest cas. Desinstal·leu el complement de tots els components abans d’eliminar-lo d’aquesta llista.

Vegeu també

ADDON_ACTIVITY_LOG_EXPIRY

Afegit a la versió 5.6.

Configura quant de temps es conserven els registres d’activitat dels complements. Per defecte, 180 dies.

WEBLATE_EXPORTERS

Afegit a la versió 4.2.

List of available exporters offering translation downloads or glossaries in various file formats.

Vegeu també

Localization file formats

WEBLATE_FORMATS

Llista de formats de fitxer disponibles per al seu ús.

Nota

La llista per defecte ja té els formats comuns.

Vegeu també

Localization file formats

WEBLATE_MACHINERY

Afegit a la versió 4.13.

Llista de serveis de maquinària disponibles per al seu ús.

Vegeu també

WEBLATE_GPG_IDENTITY

Identitat utilitzada per Weblate per signar compromisos de Git, per exemple:

WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"

L’anell de claus del Weblate GPG es cerca una clau que coincideixi (home/.gnupg a DATA_DIR). Si no es troba, es genera una clau, si us plau, comproveu Signar compromisos de Git amb GnuPG per a més detalls.

Vegeu també

Signar compromisos de Git amb GnuPG

WEBSITE_REQUIRED

Defineix si Lloc web del projecte s’ha d’especificar quan es crea un projecte. Activat per defecte, ja que s’adapta a les configuracions del servidor públic.

WEBSITE_ALERTS_ENABLED

Afegit a la versió 5.17.

Per defecte: True

Defineix si Weblate ha de comprovar la disponibilitat del lloc web del projecte i mostrar alertes de llocs web del projecte inaccessibles.

Quan s’estableix en False, Weblate ometrà les comprovacions de disponibilitat del lloc web i no generarà alertes del lloc web del projecte. Això és útil quan:

  • Els vostres llocs web estan darrere de tallafocs que bloquegen les sol·licituds de Weblate

  • Voleu evitar errors de tipus 403/503 de la protecció del bot

  • La disponibilitat del lloc web del projecte no és una preocupació per a la vostra instal·lació

Vegeu també

WEBSITE_REQUIRED

Configuring version control credentials

Suggeriment

Aquesta secció descriu les variables de credencials de VCS com GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

El diccionari de configuració consta de credencials definides per a cada host de l’API. L’amfitrió de l’API pot ser diferent del que utilitzeu al navegador web, per exemple, s’accedeix a l’API de GitHub com a api.github.com.

Les credencials també es poden substituir a URL de pujada al repositori o Repositori del codi font (si l’URL push no està configurat), aquestes tenen prioritat sobre les especificades al fitxer de configuració.

The following configuration is available for each host:

username

Usuari de l’API, obligatori.

token

Es requereix un testimoni d’API per a l’usuari de l’API.

scheme

Afegit a la versió 4.18.

Anul·lació de l’esquema. Weblate intenta analitzar l’esquema des de l’URL del dipòsit i torna a https. Si esteu executant el servidor de l’API internament, potser voldreu utilitzar http, però tingueu en compte la seguretat.

Suggeriment

Al contenidor de Docker, les credencials es poden configurar mitjançant variables d’entorn, vegeu Code-hosting sites credentials.