Summary and Setup

This is a new lesson built with The Carpentries Workbench.

Welcome to the NextGen In A Box (NGIAB) 101 training module!

Source Code and Documentation

The source code for NextGen In A Box (NGIAB) is found at our GitHub repository. The documentation for NGIAB and its extensions are found on the CIROH docs.

To dive right into NGIAB as quickly as possible, follow the quick start guide on our GitHub repository, or head straight to our second episode, Installation. If you are interested in taking your time and learning in-depth about the features of NGIAB, follow the episodes in this module.

For all users, the Key Points summary page and the Glossary may be useful references. The Advanced Topics episode is optional, but may contain useful content depending on your specific use case.

Note: This module requires you to use Bash scripting in your command line and Git. All commands will be given in this module. However, if you are interested in learning more, you can refer to this quick Bash tutorial by Ubuntu, this basic Git tutorial in the Git documentation, and this Git workflow tutorial by CIROH.

DevCon 2025 NGIAB Workshop Attendees

Are you joining us for the DevCon 2025 NGIAB workshop? We have prepared two DevCon-specific documents for you.

These documents are key, since we will not be following the default episodes exactly as written.

After the workshop, feel free to explore the rest of this module to learn more about NGIAB!

HPC Users

Are you planning on running NGIAB on an HPC? You can follow the episodes in order, but replace Episode 2: Installation and Setup with the HPC-specific instructions in the Advanced Topics module.

System Requirements

The Installation episode will walk you through the steps to install Windows Subsystem for Linux (WSL), Docker, NGIAB, and retrieve sample data sets. This page summarizes system requirements.

  • Software: Docker, Git, WSL, Astral UV
  • Recommended Minimum RAM: 8 GB
  • Software: Docker, Git, Astral UV
  • Recommended Minimum RAM: 8 GB
  • Software: Docker, Git, Astral UV
  • Recommended Minimum RAM: 8 GB