--- title: KVM slug: litmusedge-v2/quickstart-guide/installation-and-deployments/iso-installation-on-hypervisors/kvm description: You can use KVM using QEMU emulator version 2.11.1 to install Litmus Edge. docTags: createdAt: 2022-04-14T17:29:09.000Z --- You can use KVM with QEMU emulator version 2.11.1 (Debian 1:2.11+dfsg-1ubuntu7.34) or later to install Litmus Edge. :::hint{type="danger"} **Caution**: This installation has been validated using QEMU version `2.11.1` on host OS Ubuntu `20.04` and `22.04`. While newer versions of QEMU configurations may work, they have not been officially tested or guaranteed. Use newer versions at your own discretion, and ensure proper testing in your environment. ::: # Before You Begin - You must have access to QEMU emulator version 2.11.1 (Debian 1:2.11+dfsg-1ubuntu7.34) or a later version, and OS Ubuntu 20.04 or 22.04. - Make sure you have the appropriate user permissions to use the QEMU Virtual Machine Manager. To use QEMU Emulator KVM to install Litmus Edge, you will need to do the following. - Step 1: Create a Virtual Machine - Step 2: Configure Settings - Step 3: Install KVM - Step 4: Log in to Litmus Edge To jump to a specific section, refer to the Table of Contents on the right side and click the corresponding step. # Step 1: Create a Virtual Machine You will first need to create the virtual machine that will run Litmus Edge. **To create the virtual machine:** 1. From the QEMU emulator, open the Virtual Machine Manager. 2. Click **File** and select **New Virtual Machine**. The *Create a new virtual machine - step 1* dialog box appears. ## Create a new virtual machine - step 1 **To complete step 1:** 1. From the *Create new virtual machine - step 1* dialog box, select **Local install media** (**ISO image or CDROM**). 2. Click **Forward**. The *Create a new virtual machine - step 2* dialog box appears. ## Create a new virtual machine - step 2 **To complete step 2:** 1. From the *Create a new virtual machine - step 2* dialog box, select **Use ISO image**. 2. Click **Browse**. The *Choose storage volume* dialog box appears. 3. Click **Browse Local**. 4. Navigate to the ISO file and click double-click the file. The path for the image appears in the field. 5. Click **Forward**. The *Create new virtual machine - step 3* dialog box appears. ## Create a new virtual machine - step 3 **To complete step 3:** 1. From the *Create new virtual machine - step 3* *dialog box*, enter 4096 in the **Memory (RAM)** field. 2. Enter `2` in the **CPUs **field. 3. Click **Forward**. The *Create new virtual machine - step 4* dialog box appears. ## Create a new virtual machine - step 4 **To complete step 4:** 1. From the *Create new virtual machine - step 4* dialog box, select **Create a disk image for the virtual machine**. 2. Enter `20.0` in the field. 3. Click **Forward**. The *Create a new virtual machine - step 5* dialog box appears. ## Create a new virtual machine - step 5 **To complete step 5:** 1. From the *Create a new virtual machine - step 5* dialog box, enter a name for the virtual machine. 2. Under *Storage*, select **Customize configuration before install**. 3. Click the **Expand** (**v**) icon next to *Network selection*. The network selection box drops down. 4. From the options. select **Host device enp2s0: macvtap**. The source mode selection box drops down. 5. From the options, select **Bridge**. 6. Click **Finish**. The `` on QEMU/KVM dialog box appears. # Step 2: Configure Settings After installing the virtual machine, you will need to configure its settings. **To configure the settings:** 1. Navigate to the **Overview** tab in the left panel. 2. From the Firmware drop-down list, Select **UEFIx86\_64: /usr/share/OVMF/\_CODE.fd**. 3. Click **Apply**. 4. From the left panel, select **IDE Disk 1**. 5. From the *IDE Disk 1* pane, click the Expand (**v**) icon next to *Advanced options*. The disk fields drop down. 6. From the *Disk bus* drop-down list, select **SATA**. 7. Click **Apply**. 8. Click **Begin Installation**. The *Creating Virtual Machine* dialog box appears and begins the installation. 9. Click the dialog box to open the KVM OS installation application. # Step 3: Run the Operating System Installer You will run the operating system installer that will install Litmus Edge. :::hint{type="info"} **Notes**: - During the installation, the progress bar may decrease at times due to partitioning. - The time to complete the installation is based on the size of the hard disk drive. Large disk drives will cause the installation to take longer to partition the disk and therefore longer to complete setting up the virtual machine. ::: **To install KVM:** 1. From the Welcome screen, enter `No` and then press **ENTER**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/JTK6YxuDdSivoy_q26kEE_andnwrjv7o5j51j-miyfckvm-welcome-tui.png" size="80" width="787" height="614" caption="KVM OS Installer start up screen. " position="center" showCaption="true"} 2. Select **Install Operating System**, and then select **Ok**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/uOpPhO79dsLz-rV28jWL2_hxtpsbxtroefiuvvpoufckvm-install-os.png" size="80" width="787" height="616" caption="Install Operating System option" position="center" showCaption="true"} 3. Select the partition to install, and then select **Ok**. This list is device specific. Typically, the installation location is sda. If the device/gateway has embedded MMC (eMMC) components, the partition name may be listed as mmcblk instead of sda. Make sure you select the correct hard-drive location. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/s_2m0aF0fmidjyihhLBQq_ibvcwkm7ac5ozcsj37yyqkvm-select-partition.png" size="80" width="785" height="616" caption="Select partition option" position="center" showCaption="true"} 4. Verify the OS installation location by selecting **Yes**. If you select **No**, you are returned to the beginning of the installation. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/CqkLfkX4IncPKoPd4by_F_pyshkwyl6mjewquv0ihinkvm-verify-installation-location.png" size="80" width="784" height="613" caption="Installation verification" position="center" showCaption="true"} 5. A second verification ensures that you are overwriting the correct device partition during the formatting process. Select **Yes** to continue formatting the device and installing the operating system. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/HoYDSSm6-xSdiJFZ9e3lt_eoooly6ntj92hnjrngllakvm-warning.png" size="80" width="783" height="612" caption="Warning message for installatio" position="center" showCaption="true"} 6. The installer indicates its progress, followed by a success message. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/28-CQZ6Lg7y07nRvjYSVw_-nywnx6hragmfwrlmdudnkvm-installing.png" size="80" width="783" height="609" caption="Installation progress bar" position="center" showCaption="true"} 7. Select **Yes** to power off the device. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/JLunY6zS1Z2m9o_SrOMOg_ionlcldxbewdfwzpt6rxkvm-power-off.png" size="80" width="783" height="611" caption="Power off notification" position="center" showCaption="true"} 8. Reboot the device. The terminal window displays the URL which must be used to access the device using the Web UI. :::hint{type="info"} **Note**: If several URLs are displayed, the first one is used for accessing the device through the Web UI. ::: # Step 4: Configure TUI Settings **To configure the TUI settings:** 1. Press Left Control+ Left Alt to release the pointer on the TUI. The TUI settings appear. 2. Navigate to the TUI settings. 3. From the *Keyboard Layout *setting, select US, and then select **Apply**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/EdrMC9G971MPj1P-y3buX_hxt8rxwkqpyjw2dcql9ackvm-keyboard-layout.png" size="80" width="784" height="610" caption="Keyboard settings" position="center" showCaption="true"} 4. From the *Authentication *setting, enter the following credentials and log in. **Username**: `admin` **Password**: `litmusedge` ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/zoBmVrQSJYEu9sufN07S1_afafd7la7jd26ixy7tkvm-authentication.png" size="80" width="782" height="607" caption="Login screen" position="center" showCaption="true"} 5. Scroll to the bottom of the license agreement and proceed. 6. From the *Change Password* screen, enter the existing and new password and select **Change**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Inrr8XqonxDYbuAE3Oy7Y_ldndusxc5kpsyjf95wxl7kvm-change-password.png" size="80" width="785" height="611" caption="Change password screen. " position="center" showCaption="true"} 7. From the *Authentication *screen, enter `admin` as the username, your new password, and select **Log in**. ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/rFMZo6CKyPcjODXQORnAq_qu5ir3z2qphfvxbuhycqykvm-authentication2.png" size="80" width="787" height="612" caption="Authentication screen" position="center" showCaption="true"} 8. From the System settings screen, select **Configure Interfaces**, and then select **Next**. # Step 5: Log in to Litmus Edge - See [Access the Litmus Edge Web UI](docId\:Y_HKza2PmC4IRUk-EBOuK) for details on logging in. - See [Access the Terminal User Interface](docId\:gsDVWB7QWhdhuQf7fkAHC) for instructions on how to navigate and log in for the first time.