Virtual Machine

If the machine you are using is not a Linux OS, we highly recommend using VMWare or Hyper-V to run a Linux virtual machine that will run the Koios Docker container. In this part of the guide, we will discuss how to setup a basic Hyper-V machine.

Windows Home Edition

If using Hyper-V, you will need to have Windows Professional or Enterprise. Windows Home does not contain Hyper-V. VMWare however is available to Windows Home.

Enabling Hyper-V

Follow the guide below to enable Hyper-V on your system.

Microsoft guide: https://learn.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v

Creating an Ubuntu Virtual Machine

Start by downloading the .iso file for Ubuntu v22.04 from Ubuntu’s official website. You can use Ubuntu Desktop or Server, but in this example we will be using Desktop.

Download Link: https://releases.ubuntu.com/jammy/

In Hyper-V Manager, open the New Virtual Machine Wizard and setup your virtual machine.

In the Configure Network section, make sure to setup the Network Adapter to be able to access your physical machine’s network.

When prompted for the Installation Options, select the .iso file downloaded before.

Installing Ubuntu

Connect to and Start your newly created machine, you will then be prompted to try or install Ubuntu, press Enter.

Continue by selecting your language and clicking Install Ubuntu.

Follow the onscreen prompts to complete the installation. You’ll be prompted to reboot after the installation completes. After a successful reboot, you should be directed to sign in with the credentials you set up earlier in the installation.