Storage and Python environments

​

What files are being saved in my Jupyter environment?

• Files under /home/<your_username> only,
• Any conda environments you may create.

​

Any other library or file will be discarded after your session is terminated.

Filesystem

Once your Jupyter session starts, several filesystems are mounted in different locations.

• A read-only filesystem that contains code examples under /home/<your_username>/public,
• A read-only filesystem that contains the files you may had before the migration on June 14th 2022 under /home/<your_username>/old_files,
• A filesystem that contains your persistent files under /home/<your_username>,
• All other locations are not persisted.

​

Conda environments

Your Jupyter instance is initialized with default conda environments, that are reset after each session restart. List the current environments

Open a shell terminal to type the following commands, or type them directly in a notebook using the ! character.

(base) jovyan@jupyter-<your-username>:/home/<your-username>$ conda env list
# conda environments:
#
base               *     /opt/conda
climaf                   /opt/conda/envs/climaf
pcmdi                    /opt/conda/envs/pcmdi

These three default environments are installed by default and are not persisted across sessions.

However, any custom environment you may create will be persisted.

Create a custom environment

• Execute these commands with your own <env-name>, from a terminal or a notebook using the ! character.

(base) jovyan@jupyter-<your-username>:/home/<your-username>$ conda create -n <env-name> ipykernel
(base) jovyan@jupyter-<your-username>:/home/<your-username>$ conda activate <env-name>
(<env-name>) jovyan@jupyter-<your-username>:/home/<your-username>$ python -m ipykernel install --user --name <env-name>

• Finally, refresh the page using your web browser.

You should now be able to pick your newly created environment in the JupyterHub launcher.

Opening a launcher tab, you will need to select between two kernels in order to create a new empty Jupyter notebook.