main
Last updated
Developer documentation
Last updated
Last updated: 2025-04-29 01:05:53.449714 File source:
Welcome to the NuNet Appliance Installer Testnet! 🚀 This testnet allows you to install and run the NuNet appliance easily on your machine. Please note that this is a testnet, and you may encounter bugs during installation and usage. If you face any issues, feel free to reach out for support.
The NuNet Appliance allows for easy device onboarding and management of the NuNet DMS. The NuNet Appliance operates inside this VM, ensuring isolation and ease of management.
The Appliance provides a uniform environment to run the DMS in. The DMS running in the appliance provides:
Actor System - Run automated tasks and services
Peer Networking - Connect with other nodes in the network
Ensemble Management - Coordinate complex computing tasks
Prerequisites
A stable internet connection is required for a smooth installation process.
VirtualBox
Appliance Image (Provided via NuNet official channels)
At least 4GB+ RAM, 20GB+ Disk Space
Download the appliance from the link shared with you via Email or Discord. It is extremely important to make sure the email is from nunet before clicking on any links.
Open VirtualBox → File → Import Appliance. You can alternatively, double click on the appliance, this will automatically open the appliance with VirtualBox
Although resources are automatically allocated initially, you can adjust the allocated resources.(Mininum recommended: 2 CPUs, 4GB RAM, 20GB Disk Space)
DMS is initialized, enabled and started automatically when an installation is complete. it auto-starts with default configuration, hence, you do not need to do these again after a successful installation.
Note: You can interact with the appliance using the numbers on the menu item. For example, when you first land on the menu, you can select Manage NuNet DMS by inputing 1 when prompted.
When the appliance is running and you can see the menu, you can onboard resources by selecting the first item on the menu Manage NuNet DMS with the input 1. You will see a sub-menu that includes a number of things you can do with the DMS. Select option 6 to onboard maximum resources.
You can adjust the amount of resources you'd like to allocate to the appliance by going to virtual box, selecting the appliance and adjusting CPUs in the System section or RAM and Disk Storage in Storage section. Not that these adjustments can only be done when the appliance is not running.
To offboard compute, select the first item on the menu Manage NuNet DMS with the input 1. You will see a sub-menu that includes a number of things you can do with the DMS. Select option 7 to offboard comoute.
Select the first item on the menu Manage NuNet DMS with the input 1. Select option 9 to view other peers on the network.
You can view information about yourself as a peer on the network. Select option 1, Manage NuNet DMS then option 10 to view your DID, Peer ID, DMS context and Network Addresses.
You can view your running ensembles by selecting option 2 Manage Ensembles and then sub-option 1. You are likely not running an ensemble if you have just joined the network.
At the moment, you cannot run ensembles, except you are granted the rights to do so by an organisation admin. In the future, you will be able to have the option to run an ensemble locally on your node.
You can connect to an organisation by selecting option 5 on the main menu. Selecting this option gives you a list of organisations you can join. As part of the TestNet, you can join the NuNet Compute Testnet Organisation. Read all the instructions and proceed following the direction of the prompts.
DMS Not Starting
Restart DMS (Main Menu → 1. Manage NuNet DMS → 1. Start/Restart DMS)
Connection Issues
Check VM network settings
Resource Errors
Verify allocations in VirtualBox
If you encounter any issues or need assistance, feel free to reach out:
Email: support@nunet.io
Happy testing, and thank you for being part of the NuNet Appliance Installer Testnet!
Download and install VirtualBox for your machine type. Visit the
Community Forum: