In this tutorial you will create an interactive Jupyter notebook within a container then export the container in its entirety as a ‘.containds’ file for you to share with a colleague. The colleague can import it directly into their own computer’s ContainDS application, and see your notebook for themselves.

Create a new container

In ContainDS, click on the ‘+ NEW’ button and then into the ‘Image’ tab:

Click ‘SELECT’ on jupyter-minimal. After the image has been downloaded, in the configuration screen click CREATE to accept the defaults (container name and new empty folder for the workspace location).

When the container has started, and you can see the logs, click the ‘WEB’ button:

This will launch into Jupyter in your web browser.

Install some conda packages

In Jupyter, click the ‘New’ dropdown and select ‘Terminal’.

Run the following commands in the new terminal window:

conda install -y numpy
conda install -y ipywidgets
conda install -y matplotlib

Once complete, go back to the main Jupyter tree in the other browser tab. Then open up a new Python 3 notebook. Copy the cells from this notebook on GitHub.

Rename the notebook to ‘Presentation’ or similar and save it.

Export the container to a file

Close the Jupyter browser tabs, then back in ContainDS make sure the same container is still highlighted. Click on the ‘Share’ tab. The ‘Export’ sub-tab should be visible, asking for a folder location where the ‘.containds’ file should be written.

The default of your Downloads folder should be fine. Check the ‘Share as Voila presentation’ checkbox. This will ensure the recipient of your notebook can just interact with your work as an ‘app’ without having to shift-enter through the notebook and worry about the code cells.

Then just click ‘EXPORT’.

You should see some output while the container is committed and exported. Finally, the full filename of the saved file will be displayed.

Share with a colleague

You can now send that ‘.containds’ file to someone else. It will be large, so cannot be sent over email. Dropbox or a USB stick may work best.

Your colleague should install and run ContainDS, then click on the ‘File’ tab once running. Locate the ‘.containds’ file that was shared with them and click ‘Start’. Some progress information will be displayed during the import:

Once complete, the container will start and ContainDS will show you the new container’s log screen:

Click ‘WEB’ to launch straight into the Voila screen:

Click into the Presentation notebook to see the final presentation: