Skip to main content
All CollectionsWEkEO JupyterHubAbout the WEkEO JupyterHub
How to create a custom environment on WEkEO JupyterHub?
How to create a custom environment on WEkEO JupyterHub?

WEkEO's Jupyter 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 a week ago


As introduced in this article, your 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! πŸ˜ƒ

Here are the few commands to execute to create your own environment.

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

Activate the new environment:

conda activate <env-name> 

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

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

Step 3. Add the new kernel

Add the kernel and set the environment:

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

Step 4. Refresh the page

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


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:

pip install hda

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

What's next?

We are user-driven and we implement users' suggestions, so feel free to contact us:

  • through a chat session available in the bottom right corner of the page

  • via e-mail to our support team (

Did this answer your question?