School of Computer Science Wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

===== Docker =====

The School of Computer Science has several docker images available for use. Our dockerhub account is [[https://hub.docker.com/u/socsguelph|socsguelph]].

==== Installing Docker ====

Docker can be downloaded through the [[https://www.docker.com/products/docker-desktop|Docker Website]]. Direct links to the installers are also available below.

* [[https://download.docker.com/mac/stable/Docker.dmg|Docker For Mac]]
  * [[https://download.docker.com/win/stable/Docker Desktop Installer.exe|Docker for Windows]]

Docker is also available for Linux. Instructions are available for popular distributions such as [[https://docs.docker.com/install/linux/docker-ce/ubuntu/|Ubuntu]],[[https://docs.docker.com/install/linux/docker-ce/debian/|Debian]], [[https://docs.docker.com/install/linux/docker-ce/fedora/|Fedora]], or [[https://docs.docker.com/install/linux/docker-ce/centos/|CentOS]].

==== Images ====

Installing an image through Docker Hub is the easiest way to get started with a Docker Image. Once you have installed and started Docker on your machine, from a terminal run the command ''%%docker pull IMAGENAME%%'', where IMAGENAME is the name of the image you wish to install. As soon as the download has completed, your image is ready to run. See below for a list of available SoCS Image Names.

Recommend only for advanced users, you can also build a docker container using one of the linked DockerFiles below.

=== SoCS Linux ====

This image replicates the packages available on the SoCS Linux/NoMachine cluster.

**Image Name:** socsguelph/socslinux

=== CIS 6020 Jupyter ===

This is the image for running Jupyter in CIS*6020.

**Image Name:** socsguelph/jupyter-cis6020

To run this image, in a terminal, run the command ''%% docker run -p 8888:8888 socsguelph/jupyter-6020%%''.  Once the docker container has started, you will be presented with a URL that looks like "http://127.0.0.1:8888/?token=SECRETTOKEN". Copy and paste this link into a Web Browser on the same machine you are running Docker to access Jupyter.

As Docker containers are not persistent, any notebooks uploaded to Jupyter may not be available later. To mount the current working directory from your machine, such that it is available in Jupyter, run the command ''%%docker run -p 8888:8888 -v "$PWD:/home/jovyan/notebooks" socsguelph/jupyter-6020%%''. Again as before, copy the URL into your web browser to access Jupyter.

For additional documentation on Docker and Jupyter, see the [[https://jupyter-docker-stacks.readthedocs.io/en/latest/index.html|Jupyer Docker Documentation]].

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International