Foundry Appliance

A virtual appliance for building cyber labs, challenges and competitions

Overview

Foundry Appliance is a virtual machine that integrates cyber workforce development apps from the Software Engineering Institute at Carnegie Mellon University.

This project builds the virtual appliance using Ubuntu and K3s—a lightweight Kubernetes environment. Pre-built OVA images are also available under Releases.

Getting Started

After deploying the appliance, visit https://foundry.local to begin using the apps. Or login using the VM console:

username: foundry  
password: foundry

Apps

The following SEI apps are loaded on the appliance:

• TopoMojo - Virtual lab builder and player
• Gameboard - Competition manager

Build

To build the appliance, you will need:

• Packer 1.7+
• A compatible hypervisor:
  • VirtualBox (virtualbox)
  • Proxmox Virtual Environment (proxmox)

Proxmox Build (optional)

To build the appliance using Proxmox, create a file named proxmox.auto.pkrvars.hcl in this directory and add these settings:

proxmox_url      = "https://<proxmox.fqdn>:8006/api2/json" # replace with your PVE server
proxmox_user     = "root@pam"
proxmox_password = "<password>"
proxmox_node     = "pve.lan" # replace with the Proxmox node name that should build the appliance

Build Script

Run the following command, where <hypervisor> is a comma-delimited list of target hypervisors:

./build-appliance.sh <hypervisor>

For example, to build the appliance with VirtualBox, run this command:

./build-appliance.sh virtualbox

To add Proxmox to the previous build, run this command:

./build-appliance.sh virtualbox,proxmox

Packer build options can be appended to the end of the command. For example, this will save partial builds and automatically overwrite the previous build (useful for debugging):

./build-appliance.sh <hypervisor> -on-error=abort -force