You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/services/jupyterlab.md
+24-4Lines changed: 24 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,15 +35,35 @@ Alternatively, you can issue the following command directly in a notebook cell:
35
35
36
36
A kernel, in the context of Jupyter, is a program that runs the user code within the Jupyter notebooks. Jupyter kernels make it possible to access virtual environments, custom python installations like anaconda/miniconda or any custom python setting, from Jupyter notebooks.
37
37
38
-
A kernel can be created from an active Python virtual environment with `ipykernel` :
39
-
38
+
Jupyter kernels are powered by [`ipykernel`](https://github.com/ipython/ipykernel).
39
+
As a result, `ipykernel` must be installed in every environment that will be used as a kernel.
40
+
That can be done with `pip install ipykernel`.
41
+
A kernel can be created from an active Python virtual environment with the following commands
Jupyter kernels are powered by [`ipykernel`](https://github.com/ipython/ipykernel). As a result, `ipykernel` must be installed in every environment that will be used as a kernel. That could be done with `pip install ipykernel`.
48
+
## Using Uenvs in JupyterLab
49
+
50
+
In the JupyterHub Spawner Options form mentioned above, it's possible to pass an Uenv and a view.
51
+
The Uenv will be mounted at `/user-environment`, and the specified view will be activated.
52
+
53
+
If the Uenv includes the installation of a Python package, you will need to create a Jupyter kernel to make the package available in the notebooks.
54
+
If `ipykernel` is not available in the Uenv, you can create a Python virtual environment in a terminal within JupyterLab and install it there
55
+
56
+
```console
57
+
cd $SCRATCH
58
+
python -m venv uenv-pyenv --system-site-packages
59
+
pip install ipykernel
60
+
```
61
+
62
+
Then with that virtual environment activated, you can run the command to create the Jupyter kernel.
63
+
64
+
!!! warning "Using remote Uenvs for the first time."
65
+
If the Uenv is not present in the local repository, it will be automatically fetched.
66
+
As a result, JupyterLab may take slightly longer than usual to start.
47
67
48
68
## Ending your interactive session and logging out
0 commit comments