NWP Containers Online Tutorial | Introduction > Running on a local machine

Running tutorial on a local machine

To run this tutorial on a local machine, you will need to have access to a number of different utilities/software packages:

• A terminal or terminal emulator for running standard Linux/Unix commands (ls, cd, mkdir, etc.)
• untar and gzip
• A text editor such as vim, emacs, or nano
• Docker (see below)
• git (optional; see below)

More detailed instructions for certain requirements can be found below:

Installing container software

In order to run the NWP containers described in this tutorial, a containerization software (Docker or Singularity) will need to be available on your machine. To download and install the desired version software compatible with your system, please visit 

• Docker: https://www.docker.com/get-started 
• Singularity: https://sylabs.io/guides/3.6/user-guide/quick_start.html 

In order to install Docker or Singularity on your machine, you will be required to have root access privileges. Once the software has been installed, Singularity can be run without root privileges, with a few exceptions.

Docker and Singularity are updated on a regular basis; we recommended applying all available updates.

Git version control software

The scripts and Dockerfiles used during this tutorial live in a git repository. You can download a project .tar file from the Github website, or, if you wish, you can clone the repository using git software. Specific instructions for doing this will be found on subsequent pages.

If you would like to use git and it is not installed git on your machine, please visit https://git-scm.com to learn more. Prior to using git for the first time, you will need to configure your git environment. For example: