Recogito Studio

RecogitoStudio is ready for self-hosting!

Documentation

Upgrade Recogito Studio

Manual upgrade

To upgrade your self-hosted instance, you can follow the manual upgrade guide.

Automatic upgrade via shell script

For a faster, hands-off upgrade process, you can use the provided upgrade.sh script. This script automatically pulls the latest code, applies your custom configurations, builds the new Docker image, updates the database schema, and restarts your containers.

Make sure you are in the root of this repo, recogito-studio, and pull the latest version.

cd /path/to/recogito-studio
git pull

Before upgrading, compare your live .env file against the latest .env.example to ensure you aren't missing any newly required variables.

cat ./docker/.env.example

Before you can run the script for the first time, you will need to grant it execution permissions.

chmod +x upgrade.sh

Finally, execute the script.

./upgrade.sh

Note: The upgrade process builds a new Docker image from scratch and pushes schema changes to your database. Depending on your server's resources, this process usually takes a few minutes to complete.