Installing The NuNet Appliance

Appliance Types

It is important to understand that the NuNet Appliance can be installed in a few different ways, different options will work better for different scenarios. This will be discussed in greater detail later but this is the overview.

Virtual machine images (VM)

We have several Virtual machine images that can be used for both Virtualbox (that will work across all platforms - Windows, Mac, Linux) or WSL "Windows Subsystem for Linux" that will run on a modern Windows machine running an up to date version of Windows 10/11.

Cloud Init Script

The cloud init script can be used to deploy an appliance onto any cloud instance.

ISO Image

The ISO image can be used to do a "bare metal" deployment directly onto physical hardware.

Raspberry Pi Image

There is an image specifically for the raspi that you can copy directly to an SD card and boot your Raspi.

Which option should I choose ?

Initally we recommend using one of the virtual machine images to do your initial testing as its very easy to set up and can run on top of an exisiting system without having to make changes to your operating system (other than installing/configuring the relevent virtualization software)

GPU Resources

If you want the Appliance to use GPU resources in your machine then you will need to

• use Virtualbox image on MacOS (If you are using APPLE silicon e.g. any of the M series processors) or
• use the WSL appliance on Windows or
• do a bare metal install on dedicated hardware (this is the most reliable option and will give you the best performance).

Note Virtualbox does not support sharing the GPU with the Windows OS or earlier apple macs (Intel CPU) with descreete GPU's at this time.

Virtual Machine images are also useful to act as your Entry point to the network if you want to run workloads and use resources of other peers in NuNet network (like other peoples GPU's).

When you are ready to run a NuNet node to provide compute resource to the network we recommend using the ISO image to install the appliance on a dedicated machine.

System Requirements

System requirements vary depending on your intended role in the NuNet network. See the Capabilities section for detailed explanations of each role.

If you just want to test out the appliance then you will need at least: 2 CPU cores and 4 GB of ram to be able to access the network and run some simple demos.

After that look at Hardware Specs for minimum and recommended specifications based on the role you want your appliance to play on the network.

Installation Instructions

Getting Access

The NuNet Appliance is currently available through our Closed Beta program. To get access to the appliance image and join the beta testing community, please sign up for the Closed Beta.

Installation Steps using VirtualBox

Follow these steps to install and run the NuNet Appliance using VirtualBox:

1. Download and install VirtualBox

2. Download the correct Appliance Image

• AMD64 (Windows & Linux):
• ARM64 (MacOS)

3. Import into VirtualBox

• Open VirtualBox software.
• Select File → Import Appliance, then select the appliance image you just downloaded or you can Double-click the downloaded .ova file from the file manager.
• Adjust resources based on your role:
  • Compute Provider: 4+ CPUs, 8GB+ RAM, 100GB+ disk
  • Compute Consumer: 2+ CPUs, 4GB+ RAM, 20GB+ disk

4. Configure Network Settings

• In VirtualBox, select your NuNet Appliance instance and click Settings.
• Navigate to Network settings.
• Change the Attached to dropdown from NAT to Bridged Adapter.
• Select your network adapter from the Name dropdown.
• Click OK to save the settings.

Note: Bridged adapter mode allows the appliance to receive its own IP address on your local network, which is required for proper network connectivity.

5. Start the Appliance

• The NuNet appliance launches automatically on boot.
• Wait for initialization and verify you see a QR code at the end of the boot process.

⚠️ Security Reminder:
Only download official appliance images from NuNet sources

Installation Steps for WSL

Follow these steps to install and run the NuNet Appliance using VirtualBox:

1. Download and install the correct WSL image

   1. Standard (No GPU)
   2. NVIDIA GPU

2. Download the WSL NuNet appliance Installer: Powershell

3. Move both files in to the same directory and then open a powershell window as an administrator and navigate to that directory. In our example we use C:\nunet

4. Run the following command in your admin powershell window to execute the installer with the correct admin priveliges

powershell -ExecutionPolicy Bypass -File "C:\nunet\deploy-nunet-appliance-wsl.ps1" -ImagePath "C:\nunet\nuappliance-wsl-nvidia.tar.gz" -DistroName "nunetappliance"

5. The installer could take up to a few minutes run based on the capabilities of your machine.

The installer will import the NuNet Applinace as an additional WSL distribution (leaving any exisiting WSL intact) and configure some settings to directly share the windows machines IP address. It will also configure some firewall rules to allow access to the web interface from both your local machine and from other machines on your network so that you can administer it from your mobile phone.

6. When the installer has completed you will see the command you can use to run the nunet appliance

   wsl -d nunetappliance

7. Proceed to next steps

Installation Steps for Bare Metal Setup

Overview of the steps

1. Download the Appliance Image

• Bare Metal ISO (Intel & AMD): Download here

⚠️ IMPORTANT DATA LOSS WARNING This image is configured to auto-boot and automatically erase the entire internal hard disk of the computer it is started on.

2. Create a bootable USB stick using the image

Note: You will need admin privileges.

Minimum 8GB space is needed. Note that any existing data on it will be erased

We recommend that you use balenaEtcher to do this.

3. Use the USB stick to install and boot the Nunet Appliance on your device

Do not insert this USB into a computer you do not intend to erase

⚠️ Security Reminder:
Only download official appliance images from NuNet sources

Next Steps

After installation, proceed to Launching the Appliance to start the appliance and verify it's running correctly.

Hardware Specs

Compute Provider Requirements

If you plan to provide compute resources to the network:

Component	Minimum	Recommended
CPU	2 cores	4+ cores
RAM	8 GB	16 GB
Disk Space	100 GB	200 GB+
Internet	Stable broadband	High-speed broadband

Note: Compute providers need sufficient resources to run workloads allocated by the network. Higher specifications enable more concurrent allocations and better performance.

It is also recommended to enable UPnP on your router to allow for easy port forwarding setup from the Appliance web UI.

Orchestrator or Compute Consumer Requirements

If you plan to use the compute resources from the network:

Component	Minimum	Recommended
CPU	2 cores	4 cores
RAM	4 GB	8 GB
Disk Space	20 GB	40 GB
Internet	Stable broadband	High-speed broadband