Skip to content

Commit

Permalink
Add quickemu guide
Browse files Browse the repository at this point in the history
  • Loading branch information
D3vil0p3r committed Sep 6, 2024
1 parent 4179e45 commit 03dbfe0
Show file tree
Hide file tree
Showing 2 changed files with 49 additions and 0 deletions.
1 change: 1 addition & 0 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ export default defineConfig({
{ label: 'Installing as guest in VirtualBox', link: '/en/installation/install-guest-virtualbox' },
{ label: 'Installing as guest in Hyper-V', link: '/en/installation/install-guest-hyperv' },
{ label: 'Installing as guest in QEMU/KVM', link: '/en/installation/install-guest-qemu' },
{ label: 'Installing as guest in Quickemu', link: '/en/installation/install-guest-quickemu' },
{ label: 'Installing as guest in Parallels', link: '/en/installation/install-guest-parallels' },
{ label: 'Installing as guest in UTM', link: '/en/installation/install-guest-utm' },
{ label: 'Updating Athena OS', link: '/en/installation/update-athena' },
Expand Down
48 changes: 48 additions & 0 deletions src/content/docs/en/installation/install-guest-quickemu.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: Installing as guest in Quickemu
description: How to install Athena OS as as guest in Quickemu.
---
import ImageComponent from "@components/ImageComponent.astro";
import ThemedImage from '@components/ThemedImage.astro';
import { Tabs, TabItem } from '@astrojs/starlight/components';

[Quickemu](https://github.com/quickemu-project/quickemu) is a wrapper for the excellent QEMU that automatically "does the right thing" when creating virtual machines. No requirement for exhaustive configuration options. You decide what operating system you want to run and Quickemu takes care of the rest:
* `quickget` automatically downloads the upstream OS and creates the configuration;
* `quickemu` enumerates your hardware and launches the virtual machine with the optimum configuration best suited to your computer.

You can install Quickemu in your host as described in the [official documentation](https://github.com/quickemu-project/quickemu/wiki/01-Installation).
:::note
If you are installing `quickemu` on an Arch-based machine, install `qemu-desktop` package as dependency.
:::

Once Quickemu is installed, there are two simple steps to create and run Athena OS:
* **quickget** automatically downloads the ISO image for Athena OS and creates a configuration file for the virtual machine:
```shell
quickget athenaos v23.11
```
* **quickemu** starts the virtual machine using the configuration file created by `quickget`:
```shell
quickemu --vm athenaos-v23.11.conf
```
:::tip
If your host is a Linux or MacOS virtual machine, you need nested virtualization by **Intel VT-x/EPT** or **AMD-V/RVI**. To enable it, be sure that virtualization is enabled on your BIOS. If this Linux or MacOS virtual machine where to install Quickemu is running on a Windows host, disable Hyper-V by searching and opening *Turn Windows features on and off* and uncheck *Hyper-V* entry. Open CMD as Administrator and run:
```shell
bcdedit /set hypervisorlaunchtype off
```
Then, open PowerShell as Administrator and run:
```powershell
Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-All
```
Finally, reboot.
Successively, you need to enable nested virtualization on your virtualization software. Go to your Virtual Machine software settings:
<Tabs>
<TabItem label="VMware Workstation">
*Hardware* tab -> *Processors* -> check *Virtualize Intel VT-x/EPT or AMD-V/RVI*.
</TabItem>
<TabItem label="Oracle VirtualBox">
*System* tab -> *Processor* tab -> check *Enable Nested VT-x/AMD-V*.
</TabItem>
</Tabs>
Now `quickemu` machine can be virtualized inside your virtual machine.
:::
<ImageComponent />

0 comments on commit 03dbfe0

Please sign in to comment.