Upgrade Label Studio Enterprise
If you are using Label Studio Enterprise Cloud, all upgrades and updates are automatically deployed.
If you are using the on-premises version of Label Studio, you will need to take additional steps.
- Back up your databases (development and production).
- Perform the upgrade on your development server first.
- Run health checks and tests. (See below.)
- Perform the upgrade on your production server.
If you installed Label Studio Enterprise in a Kubernetes environment, you can upgrade using Helm:
- Determine the latest tag version of Label Studio Enterprise and add/replace the following in your
global: image: tag: "20210914.154442-d2d1935"
- After updating the values file, retrieve the latest updates for the Helm chart:
helm repo update heartex
- Run the following from the command line to upgrade your deployment:
If you want, you can specify a version from the command line:
helm upgrade <RELEASE_NAME> heartex/label-studio -f ls-values.yaml
This command overrides the tag value stored in
helm upgrade <RELEASE_NAME> heartex/label-studio -f ls-values.yaml --set global.image.tag=20210914.154442-d2d1935
ls-values.yaml. You must update the tag value when you upgrade or redeploy your instance to avoid version downgrades.
If you installed Label Studio Enterprise through Docker, you can upgrade using the following steps:
docker-compose.yamlto update the Label Studio Enterprise version.
docker compose up -d
- Create a new project, preferably using a more complex labeling configuration.
- Import tasks to the new project.
- From the project, click Label All Tasks. Label a few tasks and then exit the label stream.
- Label the same tasks using Quick View mode (click the tasks to open them).
- Review the labeled tasks.
- From the project’s dashboard, ensure that your work is reflected accurately (for example, if you label one task with two annotations, the dashboard should reflect non-zero statistics for the project).
- Export the tasks and verify that the JSON file accurately reflects the work that you did.
- Select a pre-existing project.
- Repeat the steps from Test 1, starting from step #2.
Ideally, you would complete this test on 3-4 projects, each with different labeling configurations and data types.