Skip to main content

How to create a custom environment on WEkEO JupyterHub?

WEkEO JupyterHub sessions are reset on restart: come and discover how to create your persistent custom conda environment!

David Bina avatar
Written by David Bina
Updated over 3 weeks ago

Context


As introduced in this article, each WEkEO JupyterHub session is initialized with default conda environments that are reset after each session restart.

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

Let's see how to create your own conda environment on the WEkEO JupyterHub! πŸ˜ƒ

Step by step Guide


Step 1. Create the environment

In the terminal, in the base environment, create your environment by setting its name:

conda create --name <env-name> ipykernel

Step 2. Activate the new environment

Then you simply need to activate the new environment:

conda activate <env-name> 

You are now in your own environment, the line in the terminal begins with:

(<env-name>) jovyan@jupyter-<your-username>:~$

Step 3. Add the new kernel

In order to be able to use the new environment (e.g. in a notebook), you first need to add the kernel as follows:

python -m ipykernel install --user --name <env-name>

Step 4. Refresh the page

Refresh the page for the changes to be taken into account.

Congrats! πŸ™Œ

You are now able to pick your own environment in the JupyterHub launcher!

πŸ“ŒNote: opening a launcher tab, you will need to select between two kernels in order to create a new empty Jupyter notebook.

Create a specific environment to use HDA


The Harmonized Data Access (HDA) is an API developed by WEkEO for downloading data in a programming approach.

After creating an environment from scratch as seen in previous section, we invite you to install the hda Python package in your new environment:

  • Via conda:

    conda install conda-forge::hda

  • Via pip:

    pip install hda

πŸ” Please check the following article to learn more on how to use the HDA:

What's next?


Additional resources can be found in our Help Center. Should you require further assistance or wish to provide feedback, feel free to contact us through a chat session available in the bottom right corner of the page.

Did this answer your question?