main
Last updated: 2025-04-08 01:05:52.084413 File source: link on GitLab
NuNet Appliance Installer Testnet
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.
What is the NuNet Appliance?
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
Installation Overview
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
Installation Instructions
Download and install VirtualBox for your machine type. Visit the official virtual box downloads page to download virtual box
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.
Basic Operations
Onboard Compute
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.
Offboard Compute
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.
View Connected Peers
Select the first item on the menu Manage NuNet DMS with the input 1. Select option 9 to view other peers on the network.
View Self Peer Information
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.
View Running Ensembles
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.
Deploy an Ensembles
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.
Connecting To an Organisation
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.
Troubleshooting
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
Need Help?
If you encounter any issues or need assistance, feel free to reach out:
Email: support@nunet.io
Community Forum: Join here
Happy testing, and thank you for being part of the NuNet Appliance Installer Testnet!
Last updated