Skip to content

Commit 9173947

Browse files
committed
add Julia in Jupyter doc
1 parent 55a00da commit 9173947

File tree

1 file changed

+22
-1
lines changed

1 file changed

+22
-1
lines changed

docs/services/jupyterlab.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ A kernel can be created from an active Python virtual environment with the follo
4545
python -m ipykernel install --user --name="<kernel-name>" --display-name="<kernel-name>"
4646
```
4747

48-
## Using uenvs in JupyterLab
48+
## Using uenvs in JupyterLab for Python
4949

5050
In the JupyterHub Spawner Options form mentioned above, it's possible to pass an uenv and a view.
5151
The uenv will be mounted at `/user-environment`, and the specified view will be activated.
@@ -65,6 +65,27 @@ Then with that virtual environment activated, you can run the command to create
6565
If the uenv is not present in the local repository, it will be automatically fetched.
6666
As a result, JupyterLab may take slightly longer than usual to start.
6767

68+
69+
## Using Julia in JupyterHub
70+
71+
Each time you start a JupyterHub server, you need to do the following in the JupyterHub Spawner Options form mentioned above:
72+
!!! important "pass a [`julia`][ref-uenv-julia] uenv and the view `jupyter`."
73+
74+
At first time use of Julia within Jupyter, IJulia and one or more Julia kernel needs to be installed. Type the following command in a shell within JupyterHub to install IJulia, the default Julia kernel and, on systems whith Nvidia GPUs, a Julia kernel running under Nvidia Nsight Systems:
75+
```console
76+
install_ijulia
77+
```
78+
79+
You can install additional custom Julia kernels by typing the following in a shell:
80+
```console
81+
julia
82+
using IJulia
83+
installkernel(<args>) # type `? installkernel` to learn about valid `<args>`
84+
```
85+
86+
!!! warning "First time use of Julia"
87+
If you are using Julia for the first time at all, executing `install_ijulia` will automatically first trigger the installation of `juliaup` and the latest `julia` version (it is also triggered if you execute `juliaup` or `julia`).
88+
6889
## Ending your interactive session and logging out
6990

7091
The Jupyter servers can be shut down through the Hub. To end a JupyterLab session, please select `Control Panel` under the `File` menu and then `Stop My Server`. By contrast, clicking `Logout` will log you out of the server, but the server will continue to run until the Slurm job reaches its maximum wall time.

0 commit comments

Comments
 (0)