JupyterLab to Apptainer

Repository with all produced Apptainer images to run Jupyter Notebooks.

List of available Notebooks

For now, here are the Notebook Apptainer images available on the Container Registry:

• notebook_solidification_oleron_2024
• notebook_gdr_iamat_2023

How to use Apptainer image of a Jupyter Notebook

Step 0 : Before using the image

If you have never used Apptainer before, you must first install it on your local machine by following these steps or check the documentation of the HPC cluster you want to use to see if it is available. It is recommended to use Apptainer v1.3.X or higher.

Step 1 : Get the image you need

Go to the Deploy section on the left panel of this repository, and in the Container Registry section. Select the image you are interested in (e.g., notebook_solidification_oleron_2024.sif) and download it using the command:

apptainer pull oras://gricad-registry.univ-grenoble-alpes.fr/diamond/jupyter/jupyterlab2apptainer/notebook_solidification_oleron_2024.sif:latest

Step 2 : Run the Jupyter Notebook

Once you have downloaded the Apptainer image, simply run the following command:

apptainer exec --bind /etc/ssl python-jupyterlab.sif jupyter lab

This will start a JupyterLab server on your machine that can be accessible on http://localhost:8888 in your web browser.

Step 3 : Stop the JupyterLab server

To stop the JupyterLab server, simply hit ctrl-c in the terminal window and enter y.