From 8bb24f69c0f795d41fe46f6e31ddde692aa1d4f5 Mon Sep 17 00:00:00 2001 From: Phil Clifford Date: Fri, 19 Aug 2022 20:10:21 +0100 Subject: [PATCH] Updated for commits direct to README --- README.md | 127 ++++++++++++++++++++++------------------ build-docs | 2 +- docs/quickemu.1 | 43 +++++++++++--- docs/quickemu.1.md | 37 +++++++++--- docs/quickemu_conf.1 | 23 +++++++- docs/quickemu_conf.1.md | 23 +++++++- docs/quickget.1 | 37 ++++++++++-- docs/quickget.1.md | 28 ++++++++- 8 files changed, 229 insertions(+), 91 deletions(-) diff --git a/README.md b/README.md index b7899c1..798b281 100644 --- a/README.md +++ b/README.md @@ -31,13 +31,17 @@ Windows**. - **macOS** Monterey, Big Sur, Catalina, Mojave & High Sierra - **Windows** 8.1, 10 and 11 including TPM 2.0 -- [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu flavours](https://ubuntu.com/download/flavours)** +- [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu + flavours](https://ubuntu.com/download/flavours)** - **Over 360 operating system editions are supported!** - Full SPICE support including host/guest clipboard sharing - VirtIO-webdavd file sharing for Linux and Windows guests - VirtIO-9p file sharing for Linux and macOS guests -- [QEMU Guest Agent support](https://wiki.qemu.org/Features/GuestAgent); provides access to a system-level agent via standard QMP commands -- Samba file sharing for Linux, macOS and Windows guests (*if `smbd` is installed on the host*) +- [QEMU Guest Agent + support](https://wiki.qemu.org/Features/GuestAgent); provides access + to a system-level agent via standard QMP commands +- Samba file sharing for Linux, macOS and Windows guests (*if `smbd` + is installed on the host*) - VirGL acceleration - USB device pass-through - Smartcard pass-through @@ -63,7 +67,8 @@ QEMU](https://img.youtube.com/vi/AOTYWEgw0hI/0.jpg)](https://www.youtube.com/wat ## Requirements -- [QEMU](https://www.qemu.org/) (*6.0.0 or newer*) **with GTK, SDL, SPICE & VirtFS support** +- [QEMU](https://www.qemu.org/) (*6.0.0 or newer*) **with GTK, SDL, + SPICE & VirtFS support** - [bash](https://www.gnu.org/software/bash/) (*4.0 or newer*) - [Coreutils](https://www.gnu.org/software/coreutils/) - [EDK II](https://github.com/tianocore/edk2) @@ -265,9 +270,10 @@ with your preferred flavour. - `opensuse` (openSUSE) - `oraclelinux` (Oracle Linux) - `popos` (Pop!\_OS) +- `reactos` (ReactOS) - `regolith` (Regolith Linux) - `rockylinux` (Rocky Linux) -- `slackware` (Slackware Linux) +- `slackware` (Slackware) - `solus` (Solus) - `tails` (Tails) - `void` (Void Linux) @@ -377,8 +383,13 @@ There are some considerations when running macOS via Quickemu. - UHCI (USB 2.0) on macOS Catalina and earlier. - XHCI (USB 3.0) on macOS Big Sur and newer. - Display resolution can only be changed via macOS System Preferences. -- **Full Duplex audio requires [VoodooHDA OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB audio-device to the macOS guest VM**. - - NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and [System Integrity Protection (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) need to be disabled to install VoodooHDA OC +- **Full Duplex audio requires [VoodooHDA + OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB + audio-device to the macOS guest VM**. +- NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and + [System Integrity Protection + (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) + need to be disabled to install VoodooHDA OC - File sharing between guest and host is available via [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). @@ -386,15 +397,15 @@ There are some considerations when running macOS via Quickemu. ### macOS App Store -If you see *"Your device or computer could not be verified"* when you try to -login to the App Store, make sure that your wired ethernet device is `en0`. Use -`ifconfig` in a terminal to verify this. +If you see *"Your device or computer could not be verified"* when you +try to login to the App Store, make sure that your wired ethernet device +is `en0`. Use `ifconfig` in a terminal to verify this. -If the wired ethernet device is not `en0`, then then go to *System Preferences* -> *Network*, -delete all the network devices and apply the changes. Next, open a terminal and -run the following: +If the wired ethernet device is not `en0`, then then go to *System +Preferences* -\> *Network*, delete all the network devices and apply the +changes. Next, open a terminal and run the following: -```bash +``` bash sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist ``` @@ -600,19 +611,20 @@ In the example above: # Disable networking -To completely disable all network interfaces in a guest VM add this additional -line to your virtual machine configuration: +To completely disable all network interfaces in a guest VM add this +additional line to your virtual machine configuration: - `network="none"` # Restricted networking -You can isolate the guest from the host (and broader network) using the restrict -option, which will restrict networking to just the guest and any virtual devices. +You can isolate the guest from the host (and broader network) using the +restrict option, which will restrict networking to just the guest and +any virtual devices. -This can be used to prevent software running inside the guest from phoning home -while still providing a network inside the guest. Add this additional line to -your virtual machine configuration: +This can be used to prevent software running inside the guest from +phoning home while still providing a network inside the guest. Add this +additional line to your virtual machine configuration: - `network="restrict"` @@ -680,46 +692,45 @@ import cog # cannot use check_result() because of non-zero return result=subprocess.run(["./quickemu", "--help"], capture_output=True, text=True) help=result.stdout -cog.out(f"```\n\n{help}\n\n```\n\n") +cog.out(f"\n```\n{help}\n```\n") ]]] --> -``` +``` - Usage - quickemu --vm ubuntu.conf - - You can also pass optional parameters - --braille : Enable braille support. Requires SDL. - --delete-disk : Delete the disk image and EFI variables - --delete-vm : Delete the entire VM and it's configuration - --display : Select display backend. 'sdl' (default), 'gtk', 'none', 'spice' or 'spice-app' - --fullscreen : Starts VM in full screen mode (Ctl+Alt+f to exit) - --ignore-msrs-always : Configure KVM to always ignore unhandled machine-specific registers - --screen : Use specified screen to determine the window size. - --shortcut : Create a desktop shortcut - --snapshot apply : Apply/restore a snapshot. - --snapshot create : Create a snapshot. - --snapshot delete : Delete a snapshot. - --snapshot info : Show disk/snapshot info. - --status-quo : Do not commit any changes to disk/snapshot. - --viewer : Choose an alternative viewer. @Options: 'spicy' (default), 'remote-viewer', 'none' - --ssh-port : Set ssh-port manually - --spice-port : Set spice-port manually - --public-dir : expose share directory. @Options: '' (default: xdg-user-dir PUBLICSHARE), '', 'none' - --monitor : Set monitor connection type. @Options: 'socket' (default), 'telnet', 'none' - --monitor-telnet-host : Set telnet host for monitor. (default: 'localhost') - --monitor-telnet-port : Set telnet port for monitor. (default: '4440') - --monitor-cmd : Send command to monitor if available. (Example: system_powerdown) - --serial : Set serial connection type. @Options: 'socket' (default), 'telnet', 'none' - --serial-telnet-host : Set telnet host for serial. (default: 'localhost') - --serial-telnet-port : Set telnet port for serial. (default: '6660') - --keyboard : Set keyboard. @Options: 'usb' (default), 'ps2', 'virtio' - --keyboard_layout : Set keyboard layout. - --mouse : Set mouse. @Options: 'tablet' (default), 'ps2', 'usb', 'virtio' - --usb-controller : Set usb-controller. @Options: 'ehci' (default), 'xhci', 'none' - --extra_args : Pass additional arguments to qemu - --version : Print version - +Usage + quickemu --vm ubuntu.conf + +You can also pass optional parameters + --braille : Enable braille support. Requires SDL. + --delete-disk : Delete the disk image and EFI variables + --delete-vm : Delete the entire VM and it's configuration + --display : Select display backend. 'sdl' (default), 'gtk', 'none', 'spice' or 'spice-app' + --fullscreen : Starts VM in full screen mode (Ctl+Alt+f to exit) + --ignore-msrs-always : Configure KVM to always ignore unhandled machine-specific registers + --screen : Use specified screen to determine the window size. + --shortcut : Create a desktop shortcut + --snapshot apply : Apply/restore a snapshot. + --snapshot create : Create a snapshot. + --snapshot delete : Delete a snapshot. + --snapshot info : Show disk/snapshot info. + --status-quo : Do not commit any changes to disk/snapshot. + --viewer : Choose an alternative viewer. @Options: 'spicy' (default), 'remote-viewer', 'none' + --ssh-port : Set ssh-port manually + --spice-port : Set spice-port manually + --public-dir : expose share directory. @Options: '' (default: xdg-user-dir PUBLICSHARE), '', 'none' + --monitor : Set monitor connection type. @Options: 'socket' (default), 'telnet', 'none' + --monitor-telnet-host : Set telnet host for monitor. (default: 'localhost') + --monitor-telnet-port : Set telnet port for monitor. (default: '4440') + --monitor-cmd : Send command to monitor if available. (Example: system_powerdown) + --serial : Set serial connection type. @Options: 'socket' (default), 'telnet', 'none' + --serial-telnet-host : Set telnet host for serial. (default: 'localhost') + --serial-telnet-port : Set telnet port for serial. (default: '6660') + --keyboard : Set keyboard. @Options: 'usb' (default), 'ps2', 'virtio' + --keyboard_layout : Set keyboard layout. + --mouse : Set mouse. @Options: 'tablet' (default), 'ps2', 'usb', 'virtio' + --usb-controller : Set usb-controller. @Options: 'ehci' (default), 'xhci', 'none' + --extra_args : Pass additional arguments to qemu + --version : Print version ``` diff --git a/build-docs b/build-docs index c881d8e..aa63963 160000 --- a/build-docs +++ b/build-docs @@ -1 +1 @@ -Subproject commit c881d8e4862a5810a4793f34626181667fde8f89 +Subproject commit aa63963073cda6f776dbbefc60b784a5425be6a9 diff --git a/docs/quickemu.1 b/docs/quickemu.1 index 98a04c0..8cb668d 100644 --- a/docs/quickemu.1 +++ b/docs/quickemu.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.18 +.\" Automatically generated by Pandoc 2.19 .\" .\" Define V font for inline verbatim, using C font in formats .\" that render this, and otherwise B font. @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "QUICKEMU" "1" "August 1, 2022" "quickemu" "Quickemu User Manual" +.TH "QUICKEMU" "1" "August 19, 2022" "quickemu" "Quickemu User Manual" .hy .SH NAME .PP @@ -75,8 +75,8 @@ Do not commit any changes to disk/snapshot. Print version .SH EXAMPLES .TP -\f[B]quickemu \[en]vm ubuntu-mate-22.04-.conf\f[R] -Launches the VM specified in the file \f[I]ubuntu-mate-22.04-.conf\f[R] +\f[B]quickemu \[en]vm ubuntu-mate-22.04.conf\f[R] +Launches the VM specified in the file \f[I]ubuntu-mate-22.04.conf\f[R] .SS Introduction .PP Quickly create and run highly optimised desktop virtual machines for @@ -88,7 +88,7 @@ For example: .nf \f[C] quickget ubuntu-mate 22.04 -quickemu --vm ubuntu-mate-22.04-.conf +quickemu --vm ubuntu-mate-22.04.conf \f[R] .fi .PP @@ -400,6 +400,8 @@ All the official Ubuntu flavours are supported, just replace .IP \[bu] 2 \f[V]popos\f[R] (Pop!_OS) .IP \[bu] 2 +\f[V]reactos\f[R] (ReactOS) +.IP \[bu] 2 \f[V]regolith\f[R] (Regolith Linux) .IP \[bu] 2 \f[V]rockylinux\f[R] (Rocky Linux) @@ -585,17 +587,40 @@ XHCI (USB 3.0) on macOS Big Sur and newer. .IP \[bu] 2 Display resolution can only be changed via macOS System Preferences. .IP \[bu] 2 -Full Duplex audio works on macOS High Sierra, Mojave and Catalina. -.RS 2 +\f[B]Full Duplex audio requires VoodooHDA +OC (https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB +audio-device to the macOS guest VM\f[R]. .IP \[bu] 2 -\f[B]macOS Big Sur and Monterey have no audio at all\f[R]. -.RE +NOTE! +Gatekeeper (https://disable-gatekeeper.github.io/) and System Integrity +Protection +(SIP) (https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) +need to be disabled to install VoodooHDA OC .IP \[bu] 2 File sharing between guest and host is available via virtio-9p (https://wiki.qemu.org/Documentation/9psetup) and SPICE webdavd (https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). .IP \[bu] 2 Copy/paste via SPICE agent is \f[B]not available on macOS\f[R]. +.SS macOS App Store +.PP +If you see \f[I]\[lq]Your device or computer could not be +verified\[rq]\f[R] when you try to login to the App Store, make sure +that your wired ethernet device is \f[V]en0\f[R]. +Use \f[V]ifconfig\f[R] in a terminal to verify this. +.PP +If the wired ethernet device is not \f[V]en0\f[R], then then go to +\f[I]System Preferences\f[R] -> \f[I]Network\f[R], delete all the +network devices and apply the changes. +Next, open a terminal and run the following: +.IP +.nf +\f[C] +sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist +\f[R] +.fi +.PP +Now reboot, and the App Store should work. .SS Windows 8.1, 10 & 11 Guests .PP \f[V]quickget\f[R] can automatically download Windows 8.1, Windows diff --git a/docs/quickemu.1.md b/docs/quickemu.1.md index 61582a9..04d1ae4 100644 --- a/docs/quickemu.1.md +++ b/docs/quickemu.1.md @@ -1,6 +1,6 @@ --- author: Martin Wimpress -date: August 1, 2022 +date: August 19, 2022 footer: quickemu header: Quickemu User Manual section: 1 @@ -68,8 +68,8 @@ You can also pass optional parameters # EXAMPLES -**quickemu --vm ubuntu-mate-22.04-.conf** -: Launches the VM specified in the file *ubuntu-mate-22.04-.conf* +**quickemu --vm ubuntu-mate-22.04.conf** +: Launches the VM specified in the file *ubuntu-mate-22.04.conf* ## Introduction @@ -80,7 +80,7 @@ way to do it for you. For example: ``` bash quickget ubuntu-mate 22.04 -quickemu --vm ubuntu-mate-22.04-.conf +quickemu --vm ubuntu-mate-22.04.conf ``` The original objective of the project was to enable quick testing of @@ -294,6 +294,7 @@ with your preferred flavour. - `opensuse` (openSUSE) - `oraclelinux` (Oracle Linux) - `popos` (Pop!\_OS) +- `reactos` (ReactOS) - `regolith` (Regolith Linux) - `rockylinux` (Rocky Linux) - `slackware` (Slackware) @@ -406,13 +407,34 @@ There are some considerations when running macOS via Quickemu. - UHCI (USB 2.0) on macOS Catalina and earlier. - XHCI (USB 3.0) on macOS Big Sur and newer. - Display resolution can only be changed via macOS System Preferences. -- Full Duplex audio works on macOS High Sierra, Mojave and Catalina. - - **macOS Big Sur and Monterey have no audio at all**. +- **Full Duplex audio requires [VoodooHDA + OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB + audio-device to the macOS guest VM**. +- NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and + [System Integrity Protection + (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) + need to be disabled to install VoodooHDA OC - File sharing between guest and host is available via [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). - Copy/paste via SPICE agent is **not available on macOS**. +### macOS App Store + +If you see *"Your device or computer could not be verified"* when you +try to login to the App Store, make sure that your wired ethernet device +is `en0`. Use `ifconfig` in a terminal to verify this. + +If the wired ethernet device is not `en0`, then then go to *System +Preferences* -\> *Network*, delete all the network devices and apply the +changes. Next, open a terminal and run the following: + +``` bash +sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist +``` + +Now reboot, and the App Store should work. + ## Windows 8.1, 10 & 11 Guests `quickget` can automatically download Windows 8.1, [Windows @@ -466,7 +488,6 @@ secureboot="on" Here are the usage instructions: - Usage quickemu --vm ubuntu.conf @@ -502,8 +523,6 @@ Here are the usage instructions: --extra_args : Pass additional arguments to qemu --version : Print version - - ## Desktop shortcuts Desktop shortcuts can be created for a VM, the shortcuts are saved in diff --git a/docs/quickemu_conf.1 b/docs/quickemu_conf.1 index d0f9480..63471eb 100644 --- a/docs/quickemu_conf.1 +++ b/docs/quickemu_conf.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.18 +.\" Automatically generated by Pandoc 2.19 .\" .\" Define V font for inline verbatim, using C font in formats .\" that render this, and otherwise B font. @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "QUICKEMU_CONF" "1" "August 1, 2022" "quickemu_conf" "Quickemu Configuration Manual" +.TH "QUICKEMU_CONF" "1" "August 19, 2022" "quickemu_conf" "Quickemu Configuration Manual" .hy .SH NAME .PP @@ -207,12 +207,29 @@ In the example above: Port 8123 on the host is forwarded to port 8123 on the guest. .IP \[bu] 2 Port 8888 on the host is forwarded to port 80 on the guest. +.SH Disable networking +.PP +To completely disable all network interfaces in a guest VM add this +additional line to your virtual machine configuration: +.IP \[bu] 2 +\f[V]network=\[dq]none\[dq]\f[R] +.SH Restricted networking +.PP +You can isolate the guest from the host (and broader network) using the +restrict option, which will restrict networking to just the guest and +any virtual devices. +.PP +This can be used to prevent software running inside the guest from +phoning home while still providing a network inside the guest. +Add this additional line to your virtual machine configuration: +.IP \[bu] 2 +\f[V]network=\[dq]restrict\[dq]\f[R] .SH Bridged networking .PP Connect your virtual machine to a preconfigured network bridge. Add an additional line to your virtual machine configuration .IP \[bu] 2 -\f[V]bridge=\[dq]br0\[dq]\f[R] +\f[V]network=\[dq]br0\[dq]\f[R] .SH USB redirection .PP Quickemu supports USB redirection via SPICE pass-through and host diff --git a/docs/quickemu_conf.1.md b/docs/quickemu_conf.1.md index e533f00..84ce1ad 100644 --- a/docs/quickemu_conf.1.md +++ b/docs/quickemu_conf.1.md @@ -1,6 +1,6 @@ --- author: Martin Wimpress -date: August 1, 2022 +date: August 19, 2022 footer: quickemu_conf header: Quickemu Configuration Manual section: 1 @@ -180,12 +180,31 @@ In the example above: - Port 8123 on the host is forwarded to port 8123 on the guest. - Port 8888 on the host is forwarded to port 80 on the guest. +# Disable networking + +To completely disable all network interfaces in a guest VM add this +additional line to your virtual machine configuration: + +- `network="none"` + +# Restricted networking + +You can isolate the guest from the host (and broader network) using the +restrict option, which will restrict networking to just the guest and +any virtual devices. + +This can be used to prevent software running inside the guest from +phoning home while still providing a network inside the guest. Add this +additional line to your virtual machine configuration: + +- `network="restrict"` + # Bridged networking Connect your virtual machine to a preconfigured network bridge. Add an additional line to your virtual machine configuration -- `bridge="br0"` +- `network="br0"` # USB redirection diff --git a/docs/quickget.1 b/docs/quickget.1 index 8d19e83..2e85efe 100644 --- a/docs/quickget.1 +++ b/docs/quickget.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.18 +.\" Automatically generated by Pandoc 2.19 .\" .\" Define V font for inline verbatim, using C font in formats .\" that render this, and otherwise B font. @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "QUICKGET" "1" "August 1, 2022" "quickget" "Quickget User Manual" +.TH "QUICKGET" "1" "August 19, 2022" "quickget" "Quickget User Manual" .hy .SH NAME .PP @@ -184,6 +184,8 @@ All the official Ubuntu flavours are supported, just replace .IP \[bu] 2 \f[V]popos\f[R] (Pop!_OS) .IP \[bu] 2 +\f[V]reactos\f[R] (ReactOS) +.IP \[bu] 2 \f[V]regolith\f[R] (Regolith Linux) .IP \[bu] 2 \f[V]rockylinux\f[R] (Rocky Linux) @@ -369,17 +371,40 @@ XHCI (USB 3.0) on macOS Big Sur and newer. .IP \[bu] 2 Display resolution can only be changed via macOS System Preferences. .IP \[bu] 2 -Full Duplex audio works on macOS High Sierra, Mojave and Catalina. -.RS 2 +\f[B]Full Duplex audio requires VoodooHDA +OC (https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB +audio-device to the macOS guest VM\f[R]. .IP \[bu] 2 -\f[B]macOS Big Sur and Monterey have no audio at all\f[R]. -.RE +NOTE! +Gatekeeper (https://disable-gatekeeper.github.io/) and System Integrity +Protection +(SIP) (https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) +need to be disabled to install VoodooHDA OC .IP \[bu] 2 File sharing between guest and host is available via virtio-9p (https://wiki.qemu.org/Documentation/9psetup) and SPICE webdavd (https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). .IP \[bu] 2 Copy/paste via SPICE agent is \f[B]not available on macOS\f[R]. +.SS macOS App Store +.PP +If you see \f[I]\[lq]Your device or computer could not be +verified\[rq]\f[R] when you try to login to the App Store, make sure +that your wired ethernet device is \f[V]en0\f[R]. +Use \f[V]ifconfig\f[R] in a terminal to verify this. +.PP +If the wired ethernet device is not \f[V]en0\f[R], then then go to +\f[I]System Preferences\f[R] -> \f[I]Network\f[R], delete all the +network devices and apply the changes. +Next, open a terminal and run the following: +.IP +.nf +\f[C] +sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist +\f[R] +.fi +.PP +Now reboot, and the App Store should work. .SS Windows 8.1, 10 & 11 Guests .PP \f[V]quickget\f[R] can automatically download Windows 8.1, Windows diff --git a/docs/quickget.1.md b/docs/quickget.1.md index 20cef24..ce09197 100644 --- a/docs/quickget.1.md +++ b/docs/quickget.1.md @@ -1,6 +1,6 @@ --- author: Martin Wimpress -date: August 1, 2022 +date: August 19, 2022 footer: quickget header: Quickget User Manual section: 1 @@ -127,6 +127,7 @@ with your preferred flavour. - `opensuse` (openSUSE) - `oraclelinux` (Oracle Linux) - `popos` (Pop!\_OS) +- `reactos` (ReactOS) - `regolith` (Regolith Linux) - `rockylinux` (Rocky Linux) - `slackware` (Slackware) @@ -239,13 +240,34 @@ There are some considerations when running macOS via Quickemu. - UHCI (USB 2.0) on macOS Catalina and earlier. - XHCI (USB 3.0) on macOS Big Sur and newer. - Display resolution can only be changed via macOS System Preferences. -- Full Duplex audio works on macOS High Sierra, Mojave and Catalina. - - **macOS Big Sur and Monterey have no audio at all**. +- **Full Duplex audio requires [VoodooHDA + OC](https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB + audio-device to the macOS guest VM**. +- NOTE! [Gatekeeper](https://disable-gatekeeper.github.io/) and + [System Integrity Protection + (SIP)](https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection) + need to be disabled to install VoodooHDA OC - File sharing between guest and host is available via [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). - Copy/paste via SPICE agent is **not available on macOS**. +### macOS App Store + +If you see *"Your device or computer could not be verified"* when you +try to login to the App Store, make sure that your wired ethernet device +is `en0`. Use `ifconfig` in a terminal to verify this. + +If the wired ethernet device is not `en0`, then then go to *System +Preferences* -\> *Network*, delete all the network devices and apply the +changes. Next, open a terminal and run the following: + +``` bash +sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist +``` + +Now reboot, and the App Store should work. + ## Windows 8.1, 10 & 11 Guests `quickget` can automatically download Windows 8.1, [Windows