JupyterLab can be installed using
If you use
conda, you can install it with:
conda install -c conda-forge jupyterlab
If you use
pip, you can install it with:
pip install jupyterlab
If installing using
pip install --user, you must add the user-level
bin directory to your
PATH environment variable in order to launch
If you use
pipenv, you can install it as:
pipenv install jupyterlab pipenv shell
or from a git checkout:
pipenv install git+git://github.com/jupyterlab/jupyterlab.git#egg=jupyterlab pipenv shell
pipenv, in order to launch
jupyter lab, you must activate the project’s virtualenv.
For example, in the directory where
Pipfile.lock live (i.e., where you ran the above commands):
pipenv shell jupyter lab
If you have Docker installed, you can install and use JupyterLab by selecting one of the many ready-to-run Docker images maintained by the Jupyter Team. Follow the instructions in the Quick Start Guide to deploy the chosen Docker image. NOTE: Ensure your docker command includes the -e JUPYTER_ENABLE_LAB=yes flag to ensure JupyterLab is enabled in your container.
Installing with Previous Versions of Notebook¶
If you are using a version of Jupyter Notebook earlier than 5.3, then you must also run the following command to enable the JupyterLab server extension:
jupyter serverextension enable --py jupyterlab --sys-prefix
JupyterLab requires the Jupyter Notebook version 4.3 or later. To check
the version of the
notebook package that you have installed:
jupyter notebook --version
Usage with JupyterHub¶
Install JupyterLab and JupyterHub.
jupyterhub_config.py, configure the
Spawner to tell the single-user notebook servers to default to JupyterLab:
c.Spawner.default_url = '/lab'
The latest versions of the following browsers are currently known to work:
Earlier browser versions may also work, but come with no guarantees.
JupyterLab uses CSS Variables for styling, which is one reason for the
minimum versions listed above. IE 11+ or Edge 14 do not support
CSS Variables, and are not directly supported at this time.
A tool like postcss can be used to convert the CSS files in the
jupyterlab/build directory manually if desired.