This tutorial will take you through launching a simple virtual environment running Jupyter Lab.

Please ensure you have already installed ContainDS Desktop and Docker (or alternatives) as described in Installation and Setup, and have ContainDS Desktop running.

Launch a Jupyter Container

After setting up and running ContainDS you should see the ‘new container’ screen:

From the list of recommended Jupyter images look for the ideonate image named ‘jupyter-scipy’. Click ‘SELECT’ next to that image.

On the next screen you can choose a different name for the new container (i.e. for the environment/workspace pair) if you like.

You need to input the workspace folder – where on your computer’s drive you would like your notebook files to be stored. The default will be an empty folder which ContainDS Desktop will create. However, you can select an existing folder which already contains notebook files or other data, perhaps cloned from a git repo. Below, we’ve left the default path for a new empty folder which will be created automatically.

Click ‘CREATE’. You will see a progress animation while the image is downloaded from Docker Hub. When the container is ready, you will see the Jupyter console logs:

Click on the ‘WEB’ button, or ‘Launch Jupyter in Browser’, to launch Jupyter in your default web browser:

You can now use Jupyter to create or view ipynb notebooks as normal. To install packages into the environment, just use Terminal within Jupyter itself (click the ‘New’ dropdown and select ‘Terminal’):

See Installing Python Packages for more details.

For full details on possibilities for starting new containers see New Container Options.

And don’t forget to sign up to our newsletter to find out about new features and guides!