# 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 #### NOTE 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. #### HINT Per als sistemes amb menys memòria de la recomanada, es recomana [Configuració d’api d’un sol procés](https://docs.weblate.org/ca/latest/admin/install.md#minimal-celery). ### Ú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: ```sh 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`](https://docs.weblate.org/ca/latest/admin/config.md#std-setting-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`](https://docs.weblate.org/ca/latest/admin/config.md#std-setting-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](https://docs.weblate.org/ca/latest/admin/install.md#architecture)) 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](https://docs.weblate.org/ca/latest/admin/install.md#database-setup)). ## Installation ### Requisits del sistema Install the dependencies needed to build the Python modules (see [Requisits de programari](https://docs.weblate.org/ca/latest/admin/install.md#requirements)): ```sh 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](https://docs.weblate.org/ca/latest/admin/install.md#python-deps)): ```sh 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ó](https://docs.weblate.org/ca/latest/admin/install.md#server), [Configuració de la base de dades per a Weblate](https://docs.weblate.org/ca/latest/admin/install.md#database-setup), [Tasques de fons amb api](https://docs.weblate.org/ca/latest/admin/install.md#celery). Depenent de la mida de la instal·lació, és possible que vulgueu executar aquests components en servidors dedicats. Les instruccions d’instal·lació local: ```sh # 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 #### HINT We’re using uv package manager to install Weblate. ```sh curl -LsSf https://astral.sh/uv/install.sh | sh ``` #### SEE ALSO [Instal·lant uv](https://docs.astral.sh/uv/getting-started/installation/) ### Mòduls Python #### HINT Estem instal·lant Weblate en un entorn Python independent. 1. Create the Python environment for Weblate: ```sh uv venv ~/weblate-env ``` 2. Activeu l’entorn Python per a Weblate: ```sh . ~/weblate-env/bin/activate ``` 3. Instal·leu Weblate incloent totes les dependències opcionals: ```sh # Install Weblate with all optional dependencies uv pip install "weblate[all]" ``` Si us plau, comproveu [Dependències de Python](https://docs.weblate.org/ca/latest/admin/install.md#python-deps) per a l’ajustament de les dependències opcionals. #### SEE ALSO * [Utilitzar entorns Python](https://docs.astral.sh/uv/pip/environments/) * [Resolució de problemes d’instal·lació de pip](https://docs.weblate.org/ca/latest/admin/install.md#troubleshoot-pip-install) ### Configuring Weblate #### NOTE 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ó](https://docs.weblate.org/ca/latest/admin/install.md#configuration). 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](https://docs.weblate.org/ca/latest/admin/install.md#database-setup) per a una configuració preparada per a la producció): ```sh weblate migrate ``` #### SEE ALSO [`migrate`](https://docs.weblate.org/ca/latest/admin/management.md#weblate-admin-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: ```sh weblate createadmin ``` #### HINT Si anteriorment us heu perdut/heu perdut la contrasenya d’administrador, podeu generar-ne una de nova amb l’ordre següent: ```sh weblate createadmin --update ``` #### SEE ALSO [`createadmin`](https://docs.weblate.org/ca/latest/admin/management.md#weblate-admin-createadmin) 5. Recolliu els fitxers estàtics per al vostre servidor web (vegeu [Servidor en execució](https://docs.weblate.org/ca/latest/admin/install.md#server) i [Donant arxius estàtics](https://docs.weblate.org/ca/latest/admin/install.md#static-files)): ```sh weblate collectstatic ``` 6. Start the Celery workers. This is not necessary for development purposes, but strongly recommended otherwise. [Tasques de fons amb api](https://docs.weblate.org/ca/latest/admin/install.md#celery) has more info: ```sh celery --app=weblate.utils worker --beat \ --queues=celery,notify,memory,translate,backup \ --prefetch-multiplier=1 ``` 7. Inicieu el servidor de desenvolupament ([Servidor en execució](https://docs.weblate.org/ca/latest/admin/install.md#server) detalla una configuració de producció): ```sh 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ó](https://docs.weblate.org/ca/latest/admin/management.md#manage). * 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](https://docs.weblate.org/ca/latest/admin/admin.md#manage-performance)) o utilitzant **weblate check --deploy**, vegeu [Configuració de producció](https://docs.weblate.org/ca/latest/admin/install.md#production). ### Afegeix traducció 1. Open the admin interface (`http://localhost:8000/create/project/`) and create the project you want to translate. See [Configuració del projecte](https://docs.weblate.org/ca/latest/admin/projects.md#project) 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](https://docs.weblate.org/ca/latest/admin/projects.md#component) per a més detalls. Els camps importants aquí són: [Nom del component](https://docs.weblate.org/ca/latest/admin/projects.md#component-name), [Repositori del codi font](https://docs.weblate.org/ca/latest/admin/projects.md#component-repo), i [Filtre de fitxers](https://docs.weblate.org/ca/latest/admin/projects.md#component-filemask) per trobar fitxers traduïbles. Weblate admet una àmplia gamma de formats, com ara [GNU gettext PO (objecte portàtil)](https://docs.weblate.org/ca/latest/formats/gettext.md#gettext), [Recursos de cadenes d’Android](https://docs.weblate.org/ca/latest/formats/android.md#aresource), [Cadenes d’iOS d’Apple](https://docs.weblate.org/ca/latest/formats/apple.md#apple), [Propietats de Java](https://docs.weblate.org/ca/latest/formats/java.md#javaprop), [Format Stringsdict](https://docs.weblate.org/ca/latest/formats/stringsdict.md#stringsdict) o [Format Fluent](https://docs.weblate.org/ca/latest/formats/fluent.md#fluent), vegeu [Localization file formats](https://docs.weblate.org/ca/latest/formats.md#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.