How to update an instance

The easiest way to update an instance while minimizing the impact on its use is to:

• stop the picture workers
• update the database schema
• update the API
• restart the updated picture workers

Update with docker compose

If you deployed Panoramax using the docker compose provided in the tutorials, check the related update section (for osm auth or keycloak).

Infrastructure migration

If the instance will be unavailable for a while, you can create a custom banner to inform the users about it.

Tip

For big infrasture migration, or database maintenance, you can set the instance as read-only, so nothing is written to the database.

Check the API_READ_ONLY setting, and make sure to stop the background workers and restart the API for this to be effective.