Install with Docker

Install with Docker#

There are video tutorials for this section which accompany the step by step instructions below.

  • Ubuntu installation video :point_right:

  • Windows installation video :point_right:

  • Mac installation video :point_right:

  1. Install Docker CE for Ubuntu, Mac OS, or Windows, including the part where you enable docker use as a non-root user.

  2. Pull the docker image from the store by typing the following command in a terminal window, or Windows users might prefer PowerShell.

    docker pull ghcr.io/fusion-energy/neutronics-workshop

    Expand - Having permission denied errors? 
    
     If you are running the command from Linux or Ubuntu terminal and getting permission denied messages back.
     Try running the same command with with elevated user permissions by adding sudo at the front.
     sudo docker pull ghcr.io/fusion-energy/neutronics-workshop
     Then enter your password when prompted.

  3. Now that you have the docker image you can enable graphics linking between your os and docker, and then run the docker container by typing the following commands in a terminal window.

    docker run -p 8888:8888 ghcr.io/fusion-energy/neutronics-workshop

    Expand - Having permission denied errors? 
    
     If you are running the command from Linux or Ubuntu terminal and getting permission denied messages back.
     Try running the same command with elevated user permissions by adding sudo at the front.
     sudo docker run -p 8888:8888 ghcr.io/fusion-energy/neutronics-workshop
     Then enter your password when prompted.

  4. A URL should be displayed in the terminal and can now be opened in the internet browser of your choice. Select and open the URL at the end of the terminal printout (highlighted below)

To check the tasks run try opening the first task in the half day workshop folder and running the Jupyter Lab code (either click on the triangular run button or click on the first code cell and press shift and enter to execute that cell).