There are 3 ways to create a session launcher on RenkuLab. Which of the situations below best describes you?

I just want to get started quickly!

Choose from the Global environments to create a session with commonly used packages pre-installed.

→ Continue below with the documentation on this page to get started!

I have a code repository that defines what packages I need.

Select the Create from Code option and let Renku build a environment based on your code for you- no knowledge of Docker required!

→ See How to create a custom environment from a code repository.

I already have a docker image I want to use.

Select the Custom Environment option to configure Renku to run your docker image.

→ See How to use your own docker image for a session launcher.


The rest of this guide will walk you through creating a basic launcher with a global environment.

In the project page:

  1. Under Sessions section click on ➕ to add a new session launcher

  2. From here, you have three options:

  3. Choose Global environment (if it’s not already selected)

    image.png