Installation¶
JupyterLab can be installed using conda
, pip
, pipenv
or docker
.
pip¶
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
jupyter lab
.
pipenv¶
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
When using pipenv
, in order to launch jupyter lab
, you must activate the project’s virtualenv.
For example, in the directory where pipenv
’s Pipfile
and Pipfile.lock
live (i.e., where you ran the above commands):
pipenv shell
jupyter lab
Docker¶
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
Prerequisites¶
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
Supported browsers¶
The latest versions of the following browsers are currently known to work:
- Firefox
- Chrome
- Safari
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.