/
Upgrade On Prem Instances

Upgrade On Prem Instances

Minor and Hotfix / Patch Upgrades

For Minor and Hotfix / Patch Upgrades (Semantic Versioning 2.0.0) it is enough to replace the docker container with the newer version. Be sure to check out the Release Notesfor whats new.

Procedure

  1. 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.

  2. Shut down the portrait instance via docker-compose down. (stop is not enough)

  3. 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 versions

    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!

  1. Startup the instance via docker-compose up -d

A general rule for how releases are handled can be found here: Release Strategy | Version Pattern.

Major Version Upgrade Matrix

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.

From

To

 

From

To

 

4.X

5.X

no upgrade path - go directly to 6.X

4.X

6.X

5.X

6.X

6.X

7.X

 

Related content

Migrate to 6.x - Schöpfl
Migrate to 6.x - Schöpfl
More like this
Migrate to 7.X - Reisalple
Migrate to 7.X - Reisalple
More like this
Portrait 7.0.0 - Reisalpe
Portrait 7.0.0 - Reisalpe
Read with this
Upgrade
More like this
ELO
Read with this
Update Portrait
Update Portrait
More like this