---
title: Requirements to Install and upgrade Label Studio
short: Requirements
tier: opensource
section: "Install & Setup"
order: 61
meta_title: Requirements to Install and Upgrade

meta_description: "Label Studio documentation: Requirements to install and upgrade Label Studio."
---

{% insertmd includes/deploy.md %}

Install prerequisite

Install Label Studio in a clean Python environment. Heartex highly recommends using a virtual environment (venv or conda) to reduce the likelihood of package conflicts or missing packages.

Install with pip

To install Label Studio with pip and a virtual environment, you need Python version 3.8 or later. Run the following:
bash python3 -m venv env source env/bin/activate python -m pip install label-studio

To install Label Studio with pip, you need Python version 3.8 or later. Run the following:
bash pip install label-studio

After you install Label Studio, start the server with the following command:
bash label-studio
The default web browser opens automatically at http://localhost:8080 with Label Studio. See start Label Studio for more options when starting Label Studio.

Install with Docker

Label Studio is also available as a Docker container. Make sure you have Docker installed on your machine.

Install with Docker on *nix
To install and start Label Studio at http://localhost:8080, storing all labeling data in ./my_project directory, run the following:
bash docker run -it -p 8080:8080 -v $(pwd)/mydata:/label-studio/data heartexlabs/label-studio:latest

!!! attention "important"
As this is a non-root container, the mounted files and directories must have the proper permissions for the UID 1001.

Install with Docker on Windows

Or for Windows, you have to modify the volumes paths set by -v option.

Override the default Docker install

You can override the default Docker install by appending new arguments.

In Windows Command Line (cmd):
bash docker run -it -p 8080:8080 -v %cd%/mydata:/label-studio/data heartexlabs/label-studio:latest label-studio --log-level DEBUG

In PowerShell:
bash docker run -it -p 8080:8080 -v ${PWD}/mydata:/label-studio/data heartexlabs/label-studio:latest label-studio --log-level DEBUG

Build a local image with Docker

If you want to build a local image, run:
bash docker build -t heartexlabs/label-studio:latest .

Run with Docker Compose

Use Docker Compose to serve Label Studio at http://localhost:8080. You must use Docker Compose version 1.25.0 or higher.

Start Label Studio:
bash docker-compose up -d

This starts Label Studio with a PostgreSQL database backend. You can also use a PostgreSQL database without Docker Compose. See Set up database storage.

Install Label Studio without internet access

Download label-studio docker image (host with internet access and docker):
bash docker pull heartexlabs/label-studio:latest

Export it as a tar archive:
bash docker save heartexlabs/label-studio:latest | gzip > label_studio_latest.tar.gz

Transfer it to another VM:
bash scp label_studio_latest.tar.gz <ANOTHER_HOST>:/tmp

SSH into and import the archive:
bash docker image import /tmp/label_studio_latest.tar.gz

Follow steps from Install and Upgrade to run LS.

Install on Ubuntu

To install Label Studio on Ubuntu and run it in a virtual environment, run the following command:

python3 -m venv env
source env/bin/activate
sudo apt install python3.9-dev
python -m pip install label-studio

Install from source

If you want to use nightly builds or extend the functionality, consider downloading the source code using Git and running Label Studio locally:

git clone https://github.com/HumanSignal/label-studio.git
cd label-studio
# Install all package dependencies
pip install -e .
# Run database migrations
python label_studio/manage.py migrate
# Start the server in development mode at http://localhost:8080
python label_studio/manage.py runserver

Install with Anaconda

conda create --name label-studio
conda activate label-studio
pip install label-studio

Upgrade Label Studio

To upgrade to the latest version of Label Studio, reinstall or upgrade using pip.

pip install --upgrade label-studio

Migration scripts run when you upgrade to version 1.0.0 from version 0.9.1 or earlier.

To make sure an existing project gets migrated, when you start Label Studio, run the following command:

label-studio start path/to/old/project 

The most important change to be aware of is changes to rename "completions" to "annotations". See the updated JSON format for completed tasks.

If you customized the Label Studio Frontend, see the Frontend reference guide for required updates to maintain compatibility with version 1.0.0.