Polyaxon makes it easy to start JupyterLab on your projects for you and your team members.


Users cnn run Jupyter Lab jobs on projects level, these jobs are subject to the same permissions of the project they belong to.

Jupyter Lab is an alternative backend when creating notebooks on Polyaxon.

To learn more about polyaxon notebook CLI, run polyaxon notebook --help, or check the command reference

Future releases will allow you to specify a default notebook image and backend to start notebooks/labs without providing a polyaxonfile

Create a polyaxonfile for your Jupyter Lab

To create a Jupyter Lab, you need a polyaxonfile to customize the container running your notebook:

version: 1

kind: notebook

backend: lab

  image: python:3
    - pip3 install jupyterlab==0.33.12

Start the Jupyter Lab

Now you can start the Jupyter Lab on the project

polyaxon notebook start -f polyaxonfile_notebook.yml

Notebook is being deployed for project `mnist`

It may take some time before you can access the dashboard.

Your notebook will be available on:

Notebook commands accept [context switching])(/references/polyaxon-cli/#switching-context) which means that you can create a Jupyter Lab for project other than the one initialized, or without initializing a local folder.

polyaxon notebook start -p my-project-name -f polyaxonfile_notebook.yml

Stop a running notebook

To stop a Jupyter Lab, run the following command in your terminal

polyaxon notebook stop


polyaxon notebook -p my-project-name stop

More info about how to customize notebooks

Learn more about the notebook concept in Polyaxon, and how you can customize notebooks run environment