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
There are two options for getting a virtual machine up and running Koios.
Option 1: Manual Installation
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.
.png "image(70).png")
Option 2: Koios ISO Installation
Ai-OPs offers the ability to download an Ubuntu .iso file with Docker and Koios already installed. This will also have the services already created and enabled. If you have a Koios ISO, please follow the steps above, but instead, select your Koios ISO when prompted for the image file. Once the install has completed, you can ensure Koios has started by running the following command in the terminal.
sudo service docker.koios statusThe bottom line will say Starting koios_ui koios_ui ...done when the service is completely running.