Depending on the specific version, you can simply upgrade Portrait by setting the new version in the docker-compose file. Other migrations need some form of manual migration.
...
Minor and Hotfix / Patch Upgrades
For Minor and Hotfix / Patch Upgrades (https://semver.org/lang/de/) it is enough to replace the docker container with the newer version. Be sure to check out the Release Notesfor whats new.
Procedure
Please make a backup of your entire configuration this may include the following files. You can download the entire folder directly via <yourInstance.com>/config by rightclick on a folder and select download.
Shut down the portrait instance via docker-compose down. (stop is not enough)
Update the .env file to use the latest version:
Example: (use the latest Minor version that is available) see https://install.portrait.app/ for all versionsCode Block BACKEND_TAG=7.0.0 FRONTEND_TAG=7.0.0 PYTHON_RUNTIME_TAG=7.0.0
Make sure to always use the same versions for all components!
Startup the instance via docker-compose up -d
A general rule for how releases are handled can be found here: https://portrait.atlassian.net/wiki/spaces/PA/blog/2022/10/20/844595201/Release+Strategy#Version-Pattern.
Major Version Upgrade Matrix
Upgrade from 6.x to 7.x
...
7.X
...
6.X
...
Upgrade with this Guide Migrate to 7.X - Reisalple
Upgrade from 4.X/5.X to 6.X
The following table describes the upgrade path to a newer version of Portrait.
| Note |
|---|
Please note that you can not skip major version upgrades. |
...
6.0.2
...
6.1.0
...
4.x
...
Major Upgrades have breaking changes that could require you to manually update your configuration (application-prod.yml) and docker compose (docker-compose.yml). Check the Migration Guides and Release Notes for more details.