Offline Installation#
This guide explains how to install DataLab on a system without internet access.
Note
This page focuses on offline installation using pip (Python package manager). For other offline installation methods, see the Other offline installation methods section below.
Offline installation via pip#
GNU/Linux Windows macOS
This method works on any operating system with Python 3.10 to 3.14. It assumes you have an online machine available to download packages, and a separate offline machine where DataLab will be installed. The commands below download wheels for the online machine’s platform: use an online machine with the same operating system, architecture and compatible platform ABI as the offline machine.
Requirements#
Offline machine#
GNU/Linux, Windows, or macOS
Python 3.10 to 3.14 installed with the same minor version (3.x) as the online machine
The same operating system and architecture, with a compatible platform ABI
No assumptions regarding installed packages
Important
Version compatibility is critical:
✅ Allowed: Python 3.10.2 ↔ Python 3.10.11 (same minor version)
❌ Not allowed: Python 3.10.x ↔ Python 3.11.x (different minor versions)
SciPy, NumPy, and scikit-image are highly dependent on the Python minor version. Both machines must use the same minor Python version for reliable offline installation.
To check your Python version, run:
python --version
Online machine#
The same operating system and architecture as the offline machine, with a compatible platform ABI
Python with the same minor version as the offline machine
pipinstalled
Preparing packages (online machine)#
Download all required Wheel packages for offline installation.
pip download selects wheels compatible with the machine running it; a
matching Python version alone is not enough for a different platform.
Create a folder for packages#
mkdir C:\datalab-offline
cd C:\datalab-offline
mkdir ~/datalab-offline
cd ~/datalab-offline
Download DataLab and dependencies#
pip download "datalab-platform[qt]" --dest C:\datalab-offline
pip download "datalab-platform[qt]" --dest ~/datalab-offline
This command downloads:
datalab-platformsigimasigimaxdatalab-capsuleplotpyguidatapythonqwtpyqt5(Qt bindings, installed by theqtextra)numpy,scipy,scikit-image, and other dependencies
Note
The OpenCV blob detection feature requires the optional opencv extra:
to use it, replace datalab-platform[qt] by datalab-platform[qt,opencv]
in the download and installation commands.
Expected folder structure#
After downloading, your folder should contain files similar to:
datalab-offline/
├─ datalab_platform‑1.x.x‑py3‑none‑any.whl
├─ sigima‑1.x.x‑py3‑none‑any.whl
├─ sigimax‑1.x.x‑py3‑none‑any.whl
├─ datalab_capsule‑0.x.x‑py3‑none‑any.whl
├─ plotpy‑x.x.x‑py3‑none‑any.whl
├─ guidata‑3.x.x‑py3‑none‑any.whl
├─ pythonqwt‑x.x.x‑py3‑none‑any.whl
├─ pyqt5‑5.x.x‑cp38‑abi3‑[platform].whl
├─ numpy‑...‑cp310‑cp310‑[platform].whl
├─ scipy‑...‑cp310‑cp310‑[platform].whl
├─ scikit_image‑...‑cp310‑cp310‑[platform].whl
└─ ...
Note
The [platform] suffix in the wheel filenames will vary depending on your
system: win_amd64 (Windows), manylinux (Linux), macosx (macOS).
Transfer to offline machine#
Transfer the datalab-offline folder to your offline machine using:
USB drive
Network share
Any other approved method in your organization
Offline installation#
On the offline machine, navigate to the folder and install DataLab.
Install DataLab offline#
python -m pip install --no-index --find-links . "datalab-platform[qt]"
The --no-index option tells pip not to connect to the internet, and
--find-links . tells pip to look for packages in the current directory.
Verification#
To verify that DataLab is installed correctly, run:
python -m datalab.app
This should launch the DataLab application.
Optional: Virtual environment#
It is recommended to install DataLab in a virtual environment to avoid conflicts with other Python packages.
Create and activate a virtual environment#
python -m venv C:\venvs\datalab
C:\venvs\datalab\Scripts\activate
python -m venv ~/venvs/datalab
source ~/venvs/datalab/bin/activate
Install DataLab in the virtual environment#
python -m pip install --no-index --find-links C:\datalab-offline "datalab-platform[qt]"
python -m pip install --no-index --find-links ~/datalab-offline "datalab-platform[qt]"
Launch DataLab#
python -m datalab.app
WinPython for offline usage#
Windows
WinPython is particularly well-suited for offline installations as it provides a portable, self-contained Python environment.
Prepare on online machine#
Download WinPython with the same minor Python version as your target system
Install WinPython
Open the WinPython Command Prompt
Download packages:
pip download "datalab-platform[qt]" --dest C:\datalab-offline
Install on offline machine#
Transfer WinPython and the
datalab-offlinefolder to the offline machineOpen the WinPython Command Prompt
Install DataLab:
cd C:\datalab-offline
python -m pip install --no-index --find-links . "datalab-platform[qt]"
Benefits of WinPython#
Portable: No installation required, can run from USB drive
Self-contained: All dependencies included
Ideal for restricted environments: No admin rights needed
Multiple versions: Can have multiple Python versions side by side
Quick summary#
The complete workflow in four steps:
On online machine: Download packages
pip download "datalab-platform[qt]" --dest /path/to/datalab-offlineTransfer: Copy the
datalab-offlinefolder to the offline machineOn offline machine: Install offline
python -m pip install --no-index --find-links /path/to/datalab-offline "datalab-platform[qt]"Verify: Launch DataLab
python -m datalab.app
Other offline installation methods#
While this guide focuses on pip-based offline installation, DataLab can also be installed offline using other methods:
Stand-alone installer (Windows)#
Windows Recommended for offline installation
The all-in-one installer is the simplest way to install DataLab offline on Windows. It does not require any Python distribution or internet connection on the target machine.
Advantages:
No Python installation required
Single executable file
Self-contained with all dependencies
No internet connection needed during installation
Works on air-gapped systems
How to use:
On a machine with internet access, download the installer from the DataLab Releases page
Transfer the installer executable to the offline machine (USB drive, network share, etc.)
Run the installer on the offline machine
For more information, see All-in-one installer.
WinPython distribution (Windows)#
Windows
DataLab-WinPython is a portable Python distribution that includes DataLab and all its dependencies.
Advantages:
Portable (can run from USB drive)
No installation required
Includes full Python environment
Can be extended with additional packages
Ideal for restricted environments
How to use:
Download DataLab-WinPython from the releases page
Transfer to the offline machine
Extract and run
For more information, see Python distribution.
Conda offline installation#
GNU/Linux Windows macOS
Conda packages can also be installed offline using a similar approach to pip:
On online machine: Download the conda package and dependencies:
conda create -n datalab-offline --download-only --json conda-forge::datalabOr use
conda list --explicitto create a specification file.Transfer the downloaded packages to the offline machine
On offline machine: Install from the local packages:
conda create -n datalab --offline -c file:///path/to/packages datalab
For more information about offline conda installation, see the Conda documentation.
For standard online installation, see Conda package.
See also
For standard online installation methods, see Installation.