# Weblate upgraden ## Docker image upgraden De officiële Weblate Docker image (bekijk [Installeren met Docker](https://docs.weblate.org/nl/latest/admin/install/docker.md)) integreert alle stappen voor upgraden. Gewoonlijk is geen handmatige interactie nodig, behoudens het ophalen van de laatste (of ten minste nieuwere) versie. #### SEE ALSO [Upgraden van de Docker container](https://docs.weblate.org/nl/latest/admin/install/docker.md#upgrading-docker) ## Algemene instructies voor upgraden Zoek altijd naar nieuwe wijzigingen in [Software vereisten](https://docs.weblate.org/nl/latest/admin/install.md#requirements) voor het upgraden. Als eenmaal alle vereisten zijn geïnstalleerd of geüpgraded, zorg er dan voor dat uw `settings.py` overeenkomt met de wijzigingen in de configuratie (raadpleeg `settings_example.py` voor de juiste waarden). Controleer altijd [Versie-specifieke instructies](#version-specific-instructions) voor het upgraden. Als u versies overslaat, zorg ervoor dat u de instructies volgt voor alle versies die u overslaat gedurende een dergelijke upgrade. Het is soms beter om geleidelijk te upgraden naar een tussenliggende versie om te zorgen voor een gladde migratie. Upgraden over meerdere uitgaven zou kunnen werken, maar is niet zo goed getest als upgraden van een enkele versie! #### NOTE Maak altijd een back-up van de volledige database voor het upgraden, zodat u de database terug kunt zetten als het upgraden mislukt, bekijk [Weblate back-uppen en verplaatsen](https://docs.weblate.org/nl/latest/admin/backup.md). 1. Wacht tot de wachtrijen van Celery leeg zijn en stop dan de processen voor WSGI en Celery om te vermijden dat oude processen worden uitgevoerd tijdens het upgraden. Anders zouden er niet compatibele wijzigingen in de database kunnen optreden. De wachtrij voor taken van Celery is geen stabiele interface tussen uitgaven, dus taken in de wachtrij van de oude versie zijn niet gegarandeerd te werken na het upgraden. U kunt de lengte van de wachtrij monitoren in de [Beheerinterface](https://docs.weblate.org/nl/latest/admin/admin.md#management-interface) of door [`celery_queues`](https://docs.weblate.org/nl/latest/admin/management.md#weblate-admin-celery_queues) te gebruiken. 2. Weblate upgraden Voor installeren met pip kan het worden bereikt met: ```sh uv pip install -U "weblate[all]==version" ``` Of, als u slechts de laatste uitgegeven versie wilt ophalen: ```sh uv pip install -U "weblate[all]" ``` Als u niet alle optionele afhankelijkheden wilt installeren, doe dan: ```sh uv pip install -U weblate ``` Met checkout van Git moet u nieuwe broncode ophalen en uw installatie bijwerken: ```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. Nieuwe uitgaven van Weblate zouden nieuwe [Python afhankelijkheden](https://docs.weblate.org/nl/latest/admin/install.md#python-deps) kunnen hebben, controleer of die van toepassing zijn voor de mogelijkheden die u wilt gebruiken. 4. Upgrade het configuratiebestand door ofwel `settings_example.py` te volgen, of [Versie-specifieke instructies](#version-specific-instructions). 5. Upgraden van de database: ```sh weblate migrate --noinput ``` 6. Verzameln bijgewerkte statische bestanden (bekijk [Server uitvoeren](https://docs.weblate.org/nl/latest/admin/install.md#server) en [Statische bestanden serveren](https://docs.weblate.org/nl/latest/admin/install.md#static-files)): ```sh weblate collectstatic --noinput ``` 7. Als u een installatie vanuit Git uitvoert, zou u ook lokale bestanden opnieuw moeten genereren, elke keer als u upgradet. U kunt dat doen door aan te roepen: ```sh weblate compilemessages ``` 8. Verifieer dat uw opstelling gezond is (bekijk ook [Productie opstelling](https://docs.weblate.org/nl/latest/admin/install.md#production)): ```sh weblate check --deploy ``` 9. Start de werker van Celery opnieuw (bekijk [Achtergrondtaken met Celery](https://docs.weblate.org/nl/latest/admin/install.md#celery)). Sommige upgrades voeren opvullen voor het bereik van het vertaalgeheugen en consolideren uit op de achtergrond met periodieke taken van Celery. Houd Celery draaiende na de upgrade en monitor de voortgang in Beheren > Rapport uitvoering. Bekijk [Bereiken van vertaalgeheugen](https://docs.weblate.org/nl/latest/admin/memory.md#memory-scopes) voor details. ## Versie-specifieke instructies #### Versionchanged Veranderd in versie 5.0: Versie specifieke instructies zijn nu opgenomen in de opmerkingen voor de uitgave, bekijk [Weblate 2026.11.2](https://docs.weblate.org/nl/latest/changes.md). ### Upgrade vanuit een oudere niet ondersteunde uitgave Direct upgraden wordt alleen ondersteund voor uitgaven uit het huidige of vorige kalenderjaar. Als u buiten deze beperking moet upgraden, upgrade dna eerst naar een tussenliggende versie, zoals hieronder vermeld. Upgraden dat deze stap overslaat wordt niet ondersteund en zal niet werken. * Als u upgradet vanuit de uitgave 2.x, upgrade altijd eerst naar 3.0.1. * Als u upgradet vanuit de uitgave 3.x, upgrade altijd eerst naar 4.0.4. * Als u upgradet vanuit de uitgave 4.x, upgrade altijd eerst naar 5.0.2. * Als u upgradet vanuit de uitgave 5.0.x-5.9.x, upgrade altijd eerst naar 5.10.4. * Upgraden vanuit 5.10.x en nieuwer wordt momenteel direct ondersteund. #### SEE ALSO * [Upgraden van 2.20 naar 3.0 in de Weblate 3.0 documentatie](https://docs.weblate.org/en/weblate-3.0.1/admin/upgrade.html#upgrade-3) * [Upgraden van 3.11 naar 4.0 in de Weblate 4.0 documentatie](https://docs.weblate.org/en/weblate-4.0.4/admin/upgrade.html#upgrade-from-3-11-to-4-0) * [Upgraden van 4.x naar 5.0.2 in Weblate 5.0 documentatie](https://docs.weblate.org/en/weblate-5.0.2/changes.html) ## Migreren vanuit andere databases naar PostgreSQL #### WARNING MySQL en MariaDB worden niet langer ondersteund in Weblate. U moet migreren naar PostgreSQL voor het upgraden. Als u Weblate uitvoert met MySQL of MariaDB, denk dan eens aan het migreren naar PostgreSQL voor betere prestaties door de volgende stappen uit te voeren. Denk eraan om, van tevoren, de servers voor web en Celery beide te stoppen, anders zou u kunnen eindigen met inconsistente gegevens. ### Een database maken in PostgreSQL Het is gewoonlijk een goed idee om Weblate uit te voeren in een afzonderlijke database en met een afzonderlijk gebruikersaccount: ```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 ``` ### Migreren naar PostgreSQL met pgloader De [pgloader](https://pgloader.io/) is een algemeen migratieprogramma voor het migreren van gegevens naar PostgreSQL. U kunt het gebruiken om uw database van Weblate te migreren. 1. Pas uw `settings.py` aan om PostgreSQL als database te gebruiken. 2. Migreer het schema in de PostgreSQL database: ```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' > ; > ``` ## Migreren vanuit Pootle Weblate werd origineel geschreven als een vervanging voor Pootle, het wordt ondersteund om de gebruikersaccounts daaruit te migreren. U kunt de gebruikers uit Pootle dumpen en ze importeren met [`importusers`](https://docs.weblate.org/nl/latest/admin/management.md#weblate-admin-importusers).