Instal·lació a RedHat, Fedora i CentOS

Requisits de maquinari

Weblate s’ha d’executar en qualsevol maquinari contemporani sense problemes, la següent és la configuració mínima necessària per executar Weblate en un sol host (Weblate, base de dades i servidor web):

  • 3 GB de RAM

  • 2 nuclis de CPU

  • 1 GB d’espai d’emmagatzematge

Nota

Els requisits reals per a la vostra instal·lació de Weblate varien molt en funció de la mida de les traduccions que hi gestionen.

Memory usage

Com més memòria millor: s’utilitza per a la memòria cau a tots els nivells (sistema de fitxers, base de dades i Weblate). Per a centenars de components de traducció, es recomana almenys 4 GB de RAM.

Suggeriment

Per als sistemes amb menys memòria de la recomanada, es recomana Configuració d’api d’un sol procés.

Ús de la CPU

Molts usuaris concurrents augmenten la quantitat de nuclis de CPU necessaris.

Weblate 2026.8 introduced NumPy as a required dependency. On x86-64 systems, the optimized NumPy build bundled in the Docker image requires an x86-64-v2 compatible CPU. Without the required CPU features, NumPy fails to load and Weblate cannot start.

Before upgrading, check for the required SSE4.2 CPU feature on the Linux system running Docker:

grep sse4_2 /proc/cpuinfo

Empty output indicates that a required CPU feature is unavailable. This is a preliminary check; finding SSE4.2 does not verify all x86-64-v2 CPU features.

If Docker runs in a virtual machine, run the check inside the guest. Virtual machines can hide CPU features supported by the host. Configure the virtual machine to expose the required host CPU features, then reboot the guest. If the physical CPU lacks the required features, upgrade the hardware.

Storage usage

L’ús típic d’emmagatzematge de bases de dades és d’uns 300 MB per cada milió de paraules allotjades.

L’espai d’emmagatzematge necessari per als dipòsits clonats varia, però Weblate intenta mantenir la seva mida mínima fent clons poc profunds.

Storage performance

Version control operations perform many filesystem metadata lookups. The vcs subdirectory in DATA_DIR therefore needs low read latency; storage with slow metadata access can make operations such as git status take a long time even when its bulk throughput is good. Keep CACHE_DIR on low-latency local or temporary storage when possible.

The deployment checks measure metadata lookup latency for both locations and warn when the median latency exceeds 10 milliseconds. This is an approximate point-in-time measurement affected by filesystem and system load. Rerun weblate check --deploy before changing the storage configuration.

Nodes

For small and medium-sized sites (millions of hosted words), all Weblate components (see Architecture overview) can be run on a single node.

Quan arribeu a centenars de milions de paraules allotjades, es recomana tenir un node dedicat per a la base de dades (vegeu Configuració de la base de dades per a Weblate).

Installation

Requisits del sistema

Install the dependencies needed to build the Python modules (see Requisits de programari):

dnf install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel libacl-devel lz4-devel libzstd-devel xxhash-devel \
   libtool-ltdl-devel python3-devel git

Instal·leu les dependències opcionals desitjades en funció de les funcions que vulgueu utilitzar (vegeu Dependències de Python):

dnf install openldap-devel cyrus-sasl-devel
dnf install xmlsec1-devel

Opcionalment, instal·leu programari per executar el servidor de producció, vegeu Servidor en execució, Configuració de la base de dades per a Weblate, Tasques de fons amb api. Depenent de la mida de la instal·lació, és possible que vulgueu executar aquests components en servidors dedicats.

Les instruccions d’instal·lació local:

# Web server option 1: NGINX and uWSGI
dnf install nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
dnf install httpd python3-mod_wsgi

# Caching backend: Valkey
dnf install valkey

# Database server: PostgreSQL
dnf install postgresql postgresql-contrib

# SMTP server
dnf install postfix

# Gettext tools for gettext POT/PO update add-ons
dnf install gettext

gestor de paquets uv

Suggeriment

We’re using uv package manager to install Weblate.

curl -LsSf https://astral.sh/uv/install.sh | sh

Vegeu també

Instal·lant uv

Mòduls Python

Suggeriment

Estem instal·lant Weblate en un entorn Python independent.

  1. Create the Python environment for Weblate:

    uv venv ~/weblate-env

  2. Activeu l’entorn Python per a Weblate:

    . ~/weblate-env/bin/activate

  3. Instal·leu Weblate incloent totes les dependències opcionals:

    # Install Weblate with all optional dependencies
uv pip install "weblate[all]"

    Si us plau, comproveu Dependències de Python per a l’ajustament de les dependències opcionals.

Vegeu també

Configuring Weblate

Nota

A continuació s’assumeix que l’entorn Python utilitzat per Weblate està activat (executant . ~/weblate-env/bin/activate). Si no, especifiqueu el camí complet a l’ordre weblate com a ~/weblate-env/bin/weblate.

  1. Copieu el fitxer ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py a ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.

  2. Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see Ajust de configuració.

  3. Creeu la base de dades i la seva estructura per a Weblate (la configuració d’exemple utilitza PostgreSQL, comproveu Configuració de la base de dades per a Weblate per a una configuració preparada per a la producció):

    weblate migrate

    Vegeu també

    migrate

  4. Creeu un compte d’usuari administrador admin, genereu la seva contrasenya i copieu-la al porta-retalls; recordeu guardar-lo per a un ús posterior:

    weblate createadmin

    Suggeriment

    Si anteriorment us heu perdut/heu perdut la contrasenya d’administrador, podeu generar-ne una de nova amb l’ordre següent:

    weblate createadmin --update

    Vegeu també

    createadmin

  5. Recolliu els fitxers estàtics per al vostre servidor web (vegeu Servidor en execució i Donant arxius estàtics):

    weblate collectstatic

  6. Start the Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. Tasques de fons amb api has more info:

    celery --app=weblate.utils worker --beat \
    --queues=celery,notify,memory,translate,backup \
    --prefetch-multiplier=1

  7. Inicieu el servidor de desenvolupament (Servidor en execució detalla una configuració de producció):

    weblate runserver

Després de la instal·lació

Enhorabona, el vostre servidor Weblate s’està executant i podeu començar a utilitzar-lo.

  • Ara podeu accedir a Weblate a http://localhost:8000/.

  • Inicieu la sessió amb les credencials d’administrador obtingudes durant la instal·lació o registreu-vos amb usuaris nous.

  • Ara podeu executar ordres Weblate mitjançant l’ordre weblate quan l’entorn Weblate Python està actiu, vegeu Ordres de gestió.

  • Podeu aturar el servidor de prova amb Ctrl+C.

  • Reviseu els problemes potencials amb la vostra instal·lació a l’URL /manage/performance/ (vegeu Informe de rendiment) o utilitzant weblate check --deploy, vegeu Configuració de producció.

Afegeix traducció

  1. Open the admin interface (http://localhost:8000/create/project/) and create the project you want to translate. See Configuració del projecte for more details.

    Tot el que heu d’especificar aquí és el nom del projecte i el seu lloc web.

  2. Creeu un component que sigui l’objecte real per a la traducció: apunta al repositori VCS i selecciona quins fitxers cal traduir. Vegeu Configuració dels components per a més detalls.

    Els camps importants aquí són: Nom del component, Repositori del codi font, i Filtre de fitxers per trobar fitxers traduïbles. Weblate admet una àmplia gamma de formats, com ara GNU gettext PO (objecte portàtil), Recursos de cadenes d’Android, Cadenes d’iOS d’Apple, Propietats de Java, Format Stringsdict o Format Fluent, vegeu Localization file formats per a més detalls.

  3. Un cop s’hagi completat l’anterior (pot ser un procés llarg depenent de la mida del vostre repositori VCS i el nombre de missatges a traduir), podeu començar a traduir.