# Upgrading Weblate

## Actualitzacions de la imatge de Docker

La imatge oficial de Weblate Docker (vegeu [Instal·lació mitjançant Docker](https://docs.weblate.org/ca/latest/admin/install/docker.md)) integra tots els passos d’actualització. Normalment, no es necessita cap interacció manual més enllà de treure la versió més recent (o almenys més recent).

#### SEE ALSO
[S’està actualitzant el contenidor Docker](https://docs.weblate.org/ca/latest/admin/install/docker.md#upgrading-docker)

<a id="generic-upgrade-instructions"></a>

## Instruccions genèriques d’actualització

Always look for new changes to [Requisits de programari](https://docs.weblate.org/ca/latest/admin/install.md#requirements) before upgrading.
Once all requirements are installed or upgraded, ensure your
`settings.py` matches the changes in the configuration (consult
`settings_example.py` for correct values).

Comproveu sempre [Version-specific instructions](#version-specific-instructions) abans d’actualitzar. Si ometeu alguna versió, assegureu-vos de seguir les instruccions de totes les versions que ometeu durant aquesta actualització. De vegades és millor actualitzar gradualment a una versió intermèdia per garantir una migració sense problemes. L’actualització en diverses versions hauria de funcionar, però no està tan ben provada com les actualitzacions d’una única versió!

#### NOTE
Always back up the full database before upgrading, so that you
can roll back the database if the upgrade fails, see [Còpia de seguretat i moviment de Weblate](https://docs.weblate.org/ca/latest/admin/backup.md).

1. Espereu que les cues d’Api es quedin buides i, a continuació, atureu els processos WSGI i Celery per evitar que els processos antics s’executin durant l’actualització. En cas contrari, es podrien produir canvis incompatibles a la base de dades.

   La cua de tasques de Celery no és una interfície estable entre les versions, de manera que no es garanteix que les tasques a la cua de la versió antiga funcionin després de l’actualització. Podeu controlar la longitud de la cua a la [Interfície de gestió](https://docs.weblate.org/ca/latest/admin/admin.md#management-interface) o utilitzant [`celery_queues`](https://docs.weblate.org/ca/latest/admin/management.md#weblate-admin-celery_queues).
2. Upgrade Weblate

   Per a les instal·lacions de pip, es pot aconseguir mitjançant:
   ```sh
   uv pip install -U "weblate[all]==version"
   ```

   O, si només voleu obtenir la darrera versió publicada:
   ```sh
   uv pip install -U "weblate[all]"
   ```

   Si no voleu instal·lar totes les dependències opcionals, feu el següent:
   ```sh
   uv pip install -U weblate
   ```

   Amb Git Checkout, heu d’aconseguir el codi font nou i actualitzar la instal·lació:
   ```sh
   cd weblate-src
   git pull
   # Update Weblate inside your Python environment
   . ~/weblate-env/bin/uv pip install -e '.[all]'
   # Install dependencies directly when not using Python environment
   uv pip install --upgrade -e .
   # Install optional dependencies directly when not using a Python environment
   uv pip install --upgrade -e '.[all]'
   ```
3. Les noves versions de Weblate poden tenir nous [Dependències de Python](https://docs.weblate.org/ca/latest/admin/install.md#python-deps), comproveu si cobreixen les funcions que voleu.
4. Actualitzeu el fitxer de configuració seguint `settings_example.py` o [Version-specific instructions](#version-specific-instructions).
5. Actualitza la base de dades:
   ```sh
   weblate migrate --noinput
   ```
6. Recolliu fitxers estàtics actualitzats (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 --noinput
   ```
7. Si esteu executant una instal·lació des de Git, també hauríeu de regenerar els fitxers de configuració regional cada vegada que actualitzeu. Podeu fer-ho invocant:
   ```sh
   weblate compilemessages
   ```
8. Verify that your setup is sane (see also [Configuració de producció](https://docs.weblate.org/ca/latest/admin/install.md#production)):
   ```sh
   weblate check --deploy
   ```
9. Reinicieu el treballador de Celery (vegeu [Tasques de fons amb api](https://docs.weblate.org/ca/latest/admin/install.md#celery)).

   Some upgrades run translation-memory scope backfill and consolidation in
   the background using periodic Celery tasks. Keep Celery running after the
   upgrade and monitor progress in Administration >
   Performance report. See [Translation-memory scopes](https://docs.weblate.org/ca/latest/admin/memory.md#memory-scopes) for details.

<a id="version-specific-instructions"></a>

## Version-specific instructions

#### Versionchanged
Canviat a la versió 5.0: Les instruccions específiques de la versió ara s’inclouen a les notes de la versió, vegeu [Weblate 2026.12](https://docs.weblate.org/ca/latest/changes.md).

### Actualitza des d’una versió anterior no compatible

Les actualitzacions directes només s’admeten per a versions de l’any natural actual o anterior. Si necessiteu actualitzar més enllà d’aquest límit, actualitzeu primer a una versió intermèdia tal com es mostra a continuació. Les actualitzacions que salten aquest pas no són compatibles i es trencaran.

* Si esteu actualitzant des de la versió 2.x, sempre primer actualitzeu a la 3.0.1.
* Si esteu actualitzant des de la versió 3.x, sempre primer actualitzeu a la 4.0.4.
* Si esteu actualitzant des de la versió 4.x, sempre primer actualitzeu a la 5.0.2.
* Si esteu actualitzant de 5.0.x-5.9.x, sempre primer actualitzeu a 5.10.4.
* Actualment, s’admeten directament les actualitzacions de 5.10.x i posteriors.

#### SEE ALSO
* [Actualitza de 2.20 a 3.0 a la documentació de Weblate 3.0](https://docs.weblate.org/en/weblate-3.0.1/admin/upgrade.html#upgrade-3)
* [Actualitza de 3.11 a 4.0 a la documentació de Weblate 4.0](https://docs.weblate.org/en/weblate-4.0.4/admin/upgrade.html#upgrade-from-3-11-to-4-0)
* [Actualitza de 4.x a 5.0.2 a la documentació de Weblate 5.0](https://docs.weblate.org/en/weblate-5.0.2/changes.html)

<a id="database-migration"></a>

## Migració d’altres bases de dades a PostgreSQL

#### WARNING
MySQL i MariaDB ja no són compatibles amb Weblate. Heu de migrar a PostgreSQL abans d’actualitzar.

Si esteu executant Weblate amb MySQL o MariaDB, considereu migrar a PostgreSQL per obtenir un millor rendiment seguint els passos següents. Recordeu aturar els dos servidors web i Celery per endavant, en cas contrari, podríeu acabar amb dades inconsistents.

### Creació d’una base de dades en PostgreSQL

Normalment és una bona idea executar Weblate en una base de dades independent i un compte d’usuari independent:

```sh
# If PostgreSQL was not installed before, set the main password
sudo -u postgres psql postgres -c "\password postgres"

# Create a database user called "weblate"
sudo -u postgres createuser -D -P weblate

# Create the database "weblate" owned by "weblate"
sudo -u postgres createdb -E UTF8 -O weblate weblate
```

<a id="pgloader-migration"></a>

### Migració a PostgreSQL mitjançant pgloader

El [pgloader](https://pgloader.io/) és una eina de migració genèrica per migrar dades a PostgreSQL. Podeu utilitzar-lo per migrar la vostra base de dades Weblate.

1. Ajusteu el vostre `settings.py` per utilitzar PostgreSQL com a base de dades.
2. Migreu l’esquema a la base de dades PostgreSQL:
   ```sh
   weblate migrate
   weblate sqlflush | weblate dbshell
   ```

3. Run the pgloader to transfer the data.
The following script can be used to migrate the database, but you might
want to learn more about [pgloader](https://pgloader.io/) to better understand what it does,
and tweak it to match your setup:

> ```postgresql
> LOAD DATABASE
>      FROM mysql://weblate:password@localhost/weblate
>      INTO postgresql://weblate:password@localhost/weblate

> WITH include no drop, truncate, create no tables, create no indexes, no foreign keys, disable triggers, reset sequences, data only

> ALTER SCHEMA 'weblate' RENAME TO 'public'
> ;
> ```

<a id="pootle-migration"></a>

## Migrant des de Pootle

Com que Weblate es va escriure originalment com a reemplaçament de Pootle, s’admet per migrar-ne els comptes d’usuari. Podeu abocar els usuaris de Pootle i importar-los mitjançant [`importusers`](https://docs.weblate.org/ca/latest/admin/management.md#weblate-admin-importusers).
