Hyper-V
This guide walks you through installing Barbara OS on a Hyper-V virtual machine on a Microsoft Windows system.
Hyper-V virtualization is supported on Windows Professional editions.
The minimum supported operating system is Windows Server 2019.
Pre-requisites
-
Enable Hyper-V: Before you begin, ensure Hyper-V is activated on your Windows system. You can find detailed instructions in this article.
-
Download Barbara OS Image: Download the compressed file (.zip) containing the Barbara OS image from your Barbara Panel. Extract the contents to a convenient location on your local system.

Downloading Hyper-V OS Image
General Hardware Requirements
Minimum
- RAM: 2GB
- Hard Drive: 32GB
- Processor: 1 processor / 2 cores
- Network: 1 x Ethernet Interface
Recommended
- RAM: 4GB
- Hard Drive: 64GB
- Processor: 2 processor / 2 cores
- Network: 2 x Ethernet Interface
Creating the Virtual Machine
- Launch the Hyper-V Manager application on your Windows system and click the New Virtual Machine option:

Select New Virtual Machine
- Specify Name Provide a descriptive name for your virtual machine (e.g., "Barbara-Edge-Node") and click "Next":

Specify a Name
- Select Generation 2 for the virtual machine and click Next:

Select Generation 2 for the Virtual Machine
- Allocate memory. Assign memory for the virtual machine. We recommend a minimum of 2048 MB (2 GB). Keep the "Dynamic Memory" option selected and click "Next":

Select Memory for the Virtual Machine
- Configure Network. Select the Default Switch as the network adapter for the virtual machine and click Next:

Select Default Switch
- Connect Virtual Disk. In "Connect Virtual Disk" section, select "use an existing hard disk" and select the VHDX file downloaded from Panel.

Select Downloaded OS
- Review Configuration. Review the summary of your virtual machine configuration settings and confirm everything is accurate before clicking Next:

Review configuration
- Disable Secure Boot. After creating the virtual machine, navigate to its "Settings" and select the "Security" option. Here, ensure "Secure Boot" is disabled.

Disable Secure Bootup
Connecting and Booting
-
Connect to Virtual Machine: Establish a connection to your newly created virtual machine within Hyper-V Manager.
-
Initiate Boot Process: Once connected, locate the "Start" option and click it to begin the boot process for the Barbara OS image within the Hyper-V virtual machine.

Connect Virtual Machine
- System Booting Up: Observe the boot process as Barbara OS initializes on your virtual machine.

Booting Up Barbara
By following these steps, you'll successfully deploy and run Barbara OS in a Hyper-V virtual machine, allowing you to test and explore its functionalities within a simulated edge computing environment.