oSoWoSo/DistroHopper
1
0
Fork 0
mirror of https://github.com/oSoWoSo/DistroHopper.git synced 2024-08-14 22:46:53 +00:00
Code Issues Projects Releases Packages Wiki Activity

Updated for commits direct to README

Browse source
This commit is contained in:
Phil Clifford 2022-08-19 20:10:21 +01:00 • committed by Martin Wimpress
parent d669c4ca2a
commit 8bb24f69c0
8 changed files with 228 additions and 90 deletions
Download patch file Download diff file Expand all files Collapse all files

125
README.md
View file

@ -31,13 +31,17 @@ Windows**.
- **macOS** Monterey, Big Sur, Catalina, Mojave & High Sierra - **macOS** Monterey, Big Sur, Catalina, Mojave & High Sierra
- **Windows** 8.1, 10 and 11 including TPM 2.0 - **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!** - **Over 360 operating system editions are supported!**
- Full SPICE support including host/guest clipboard sharing - Full SPICE support including host/guest clipboard sharing
- VirtIO-webdavd file sharing for Linux and Windows guests - VirtIO-webdavd file sharing for Linux and Windows guests
- VirtIO-9p file sharing for Linux and macOS 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 - [QEMU Guest Agent
- Samba file sharing for Linux, macOS and Windows guests (*if `smbd` is installed on the host*) 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 - VirGL acceleration
- USB device pass-through - USB device pass-through
- Smartcard pass-through - Smartcard pass-through
@ -63,7 +67,8 @@ QEMU](https://img.youtube.com/vi/AOTYWEgw0hI/0.jpg)](https://www.youtube.com/wat
## Requirements ## 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*) - [bash](https://www.gnu.org/software/bash/) (*4.0 or newer*)
- [Coreutils](https://www.gnu.org/software/coreutils/) - [Coreutils](https://www.gnu.org/software/coreutils/)
- [EDK II](https://github.com/tianocore/edk2) - [EDK II](https://github.com/tianocore/edk2)
@ -265,9 +270,10 @@ with your preferred flavour.
- `opensuse` (openSUSE) - `opensuse` (openSUSE)
- `oraclelinux` (Oracle Linux) - `oraclelinux` (Oracle Linux)
- `popos` (Pop!\_OS) - `popos` (Pop!\_OS)
- `reactos` (ReactOS)
- `regolith` (Regolith Linux) - `regolith` (Regolith Linux)
- `rockylinux` (Rocky Linux) - `rockylinux` (Rocky Linux)
- `slackware` (Slackware Linux) - `slackware` (Slackware)
- `solus` (Solus) - `solus` (Solus)
- `tails` (Tails) - `tails` (Tails)
- `void` (Void Linux) - `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. - UHCI (USB 2.0) on macOS Catalina and earlier.
- XHCI (USB 3.0) on macOS Big Sur and newer. - XHCI (USB 3.0) on macOS Big Sur and newer.
- Display resolution can only be changed via macOS System Preferences. - 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**. - **Full Duplex audio requires [VoodooHDA
- 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 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 - File sharing between guest and host is available via
[virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE
webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). 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 ### macOS App Store
If you see *"Your device or computer could not be verified"* when you try to If you see *"Your device or computer could not be verified"* when you
login to the App Store, make sure that your wired ethernet device is `en0`. Use try to login to the App Store, make sure that your wired ethernet device
`ifconfig` in a terminal to verify this. 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*, If the wired ethernet device is not `en0`, then then go to *System
delete all the network devices and apply the changes. Next, open a terminal and Preferences* -\> *Network*, delete all the network devices and apply the
run the following: changes. Next, open a terminal and run the following:
```bash ``` bash
sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist sudo rm /Library/Preferences/SystemConfiguration/NetworkInterfaces.plist
``` ```
@ -600,19 +611,20 @@ In the example above:
# Disable networking # Disable networking
To completely disable all network interfaces in a guest VM add this additional To completely disable all network interfaces in a guest VM add this
line to your virtual machine configuration: additional line to your virtual machine configuration:
- `network="none"` - `network="none"`
# Restricted networking # Restricted networking
You can isolate the guest from the host (and broader network) using the restrict You can isolate the guest from the host (and broader network) using the
option, which will restrict networking to just the guest and any virtual devices. 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 This can be used to prevent software running inside the guest from
while still providing a network inside the guest. Add this additional line to phoning home while still providing a network inside the guest. Add this
your virtual machine configuration: additional line to your virtual machine configuration:
- `network="restrict"` - `network="restrict"`
@ -680,46 +692,45 @@ import cog
# cannot use check_result() because of non-zero return # cannot use check_result() because of non-zero return
result=subprocess.run(["./quickemu", "--help"], capture_output=True, text=True) result=subprocess.run(["./quickemu", "--help"], capture_output=True, text=True)
help=result.stdout 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
Usage You can also pass optional parameters
quickemu --vm ubuntu.conf --braille : Enable braille support. Requires SDL.
--delete-disk : Delete the disk image and EFI variables
You can also pass optional parameters --delete-vm : Delete the entire VM and it's configuration
--braille : Enable braille support. Requires SDL. --display : Select display backend. 'sdl' (default), 'gtk', 'none', 'spice' or 'spice-app'
--delete-disk : Delete the disk image and EFI variables --fullscreen : Starts VM in full screen mode (Ctl+Alt+f to exit)
--delete-vm : Delete the entire VM and it's configuration --ignore-msrs-always : Configure KVM to always ignore unhandled machine-specific registers
--display : Select display backend. 'sdl' (default), 'gtk', 'none', 'spice' or 'spice-app' --screen <screen> : Use specified screen to determine the window size.
--fullscreen : Starts VM in full screen mode (Ctl+Alt+f to exit) --shortcut : Create a desktop shortcut
--ignore-msrs-always : Configure KVM to always ignore unhandled machine-specific registers --snapshot apply <tag> : Apply/restore a snapshot.
--screen <screen> : Use specified screen to determine the window size. --snapshot create <tag> : Create a snapshot.
--shortcut : Create a desktop shortcut --snapshot delete <tag> : Delete a snapshot.
--snapshot apply <tag> : Apply/restore a snapshot. --snapshot info : Show disk/snapshot info.
--snapshot create <tag> : Create a snapshot. --status-quo : Do not commit any changes to disk/snapshot.
--snapshot delete <tag> : Delete a snapshot. --viewer <viewer> : Choose an alternative viewer. @Options: 'spicy' (default), 'remote-viewer', 'none'
--snapshot info : Show disk/snapshot info. --ssh-port <port> : Set ssh-port manually
--status-quo : Do not commit any changes to disk/snapshot. --spice-port <port> : Set spice-port manually
--viewer <viewer> : Choose an alternative viewer. @Options: 'spicy' (default), 'remote-viewer', 'none' --public-dir <path> : expose share directory. @Options: '' (default: xdg-user-dir PUBLICSHARE), '<directory>', 'none'
--ssh-port <port> : Set ssh-port manually --monitor <type> : Set monitor connection type. @Options: 'socket' (default), 'telnet', 'none'
--spice-port <port> : Set spice-port manually --monitor-telnet-host <ip/host> : Set telnet host for monitor. (default: 'localhost')
--public-dir <path> : expose share directory. @Options: '' (default: xdg-user-dir PUBLICSHARE), '<directory>', 'none' --monitor-telnet-port <port> : Set telnet port for monitor. (default: '4440')
--monitor <type> : Set monitor connection type. @Options: 'socket' (default), 'telnet', 'none' --monitor-cmd <cmd> : Send command to monitor if available. (Example: system_powerdown)
--monitor-telnet-host <ip/host> : Set telnet host for monitor. (default: 'localhost') --serial <type> : Set serial connection type. @Options: 'socket' (default), 'telnet', 'none'
--monitor-telnet-port <port> : Set telnet port for monitor. (default: '4440') --serial-telnet-host <ip/host> : Set telnet host for serial. (default: 'localhost')
--monitor-cmd <cmd> : Send command to monitor if available. (Example: system_powerdown) --serial-telnet-port <port> : Set telnet port for serial. (default: '6660')
--serial <type> : Set serial connection type. @Options: 'socket' (default), 'telnet', 'none' --keyboard <type> : Set keyboard. @Options: 'usb' (default), 'ps2', 'virtio'
--serial-telnet-host <ip/host> : Set telnet host for serial. (default: 'localhost') --keyboard_layout <layout> : Set keyboard layout.
--serial-telnet-port <port> : Set telnet port for serial. (default: '6660') --mouse <type> : Set mouse. @Options: 'tablet' (default), 'ps2', 'usb', 'virtio'
--keyboard <type> : Set keyboard. @Options: 'usb' (default), 'ps2', 'virtio' --usb-controller <type> : Set usb-controller. @Options: 'ehci' (default), 'xhci', 'none'
--keyboard_layout <layout> : Set keyboard layout. --extra_args <arguments> : Pass additional arguments to qemu
--mouse <type> : Set mouse. @Options: 'tablet' (default), 'ps2', 'usb', 'virtio' --version : Print version
--usb-controller <type> : Set usb-controller. @Options: 'ehci' (default), 'xhci', 'none'
--extra_args <arguments> : Pass additional arguments to qemu
--version : Print version
``` ```
<!-- [[[end]]] --> <!-- [[[end]]] -->

2
build-docs

@ -1 +1 @@
Subproject commit c881d8e4862a5810a4793f34626181667fde8f89 Subproject commit aa63963073cda6f776dbbefc60b784a5425be6a9

43
docs/quickemu.1
View file

@ -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 .\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font. .\" that render this, and otherwise B font.
@ -14,7 +14,7 @@
. ftr VB CB . ftr VB CB
. ftr VBI CBI . ftr VBI CBI
.\} .\}
.TH "QUICKEMU" "1" "August 1, 2022" "quickemu" "Quickemu User Manual" .TH "QUICKEMU" "1" "August 19, 2022" "quickemu" "Quickemu User Manual"
.hy .hy
.SH NAME .SH NAME
.PP .PP
@ -75,8 +75,8 @@ Do not commit any changes to disk/snapshot.
Print version Print version
.SH EXAMPLES .SH EXAMPLES
.TP .TP
\f[B]quickemu \[en]vm 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] Launches the VM specified in the file \f[I]ubuntu-mate-22.04.conf\f[R]
.SS Introduction .SS Introduction
.PP .PP
Quickly create and run highly optimised desktop virtual machines for Quickly create and run highly optimised desktop virtual machines for
@ -88,7 +88,7 @@ For example:
.nf .nf
\f[C] \f[C]
quickget ubuntu-mate 22.04 quickget ubuntu-mate 22.04
quickemu --vm ubuntu-mate-22.04-.conf quickemu --vm ubuntu-mate-22.04.conf
\f[R] \f[R]
.fi .fi
.PP .PP
@ -400,6 +400,8 @@ All the official Ubuntu flavours are supported, just replace
.IP \[bu] 2 .IP \[bu] 2
\f[V]popos\f[R] (Pop!_OS) \f[V]popos\f[R] (Pop!_OS)
.IP \[bu] 2 .IP \[bu] 2
\f[V]reactos\f[R] (ReactOS)
.IP \[bu] 2
\f[V]regolith\f[R] (Regolith Linux) \f[V]regolith\f[R] (Regolith Linux)
.IP \[bu] 2 .IP \[bu] 2
\f[V]rockylinux\f[R] (Rocky Linux) \f[V]rockylinux\f[R] (Rocky Linux)
@ -585,17 +587,40 @@ XHCI (USB 3.0) on macOS Big Sur and newer.
.IP \[bu] 2 .IP \[bu] 2
Display resolution can only be changed via macOS System Preferences. Display resolution can only be changed via macOS System Preferences.
.IP \[bu] 2 .IP \[bu] 2
Full Duplex audio works on macOS High Sierra, Mojave and Catalina. \f[B]Full Duplex audio requires VoodooHDA
.RS 2 OC (https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB
audio-device to the macOS guest VM\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[B]macOS Big Sur and Monterey have no audio at all\f[R]. NOTE!
.RE 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 .IP \[bu] 2
File sharing between guest and host is available via File sharing between guest and host is available via
virtio-9p (https://wiki.qemu.org/Documentation/9psetup) and SPICE virtio-9p (https://wiki.qemu.org/Documentation/9psetup) and SPICE
webdavd (https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). webdavd (https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
.IP \[bu] 2 .IP \[bu] 2
Copy/paste via SPICE agent is \f[B]not available on macOS\f[R]. 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 .SS Windows 8.1, 10 & 11 Guests
.PP .PP
\f[V]quickget\f[R] can automatically download Windows 8.1, Windows \f[V]quickget\f[R] can automatically download Windows 8.1, Windows

37
docs/quickemu.1.md
View file

@ -1,6 +1,6 @@
--- ---
author: Martin Wimpress author: Martin Wimpress
date: August 1, 2022 date: August 19, 2022
footer: quickemu footer: quickemu
header: Quickemu User Manual header: Quickemu User Manual
section: 1 section: 1
@ -68,8 +68,8 @@ You can also pass optional parameters
# EXAMPLES # EXAMPLES
**quickemu --vm ubuntu-mate-22.04-.conf** **quickemu --vm ubuntu-mate-22.04.conf**
: Launches the VM specified in the file *ubuntu-mate-22.04-.conf* : Launches the VM specified in the file *ubuntu-mate-22.04.conf*
## Introduction ## Introduction
@ -80,7 +80,7 @@ way to do it for you. For example:
``` bash ``` bash
quickget ubuntu-mate 22.04 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 The original objective of the project was to enable quick testing of
@ -294,6 +294,7 @@ with your preferred flavour.
- `opensuse` (openSUSE) - `opensuse` (openSUSE)
- `oraclelinux` (Oracle Linux) - `oraclelinux` (Oracle Linux)
- `popos` (Pop!\_OS) - `popos` (Pop!\_OS)
- `reactos` (ReactOS)
- `regolith` (Regolith Linux) - `regolith` (Regolith Linux)
- `rockylinux` (Rocky Linux) - `rockylinux` (Rocky Linux)
- `slackware` (Slackware) - `slackware` (Slackware)
@ -406,13 +407,34 @@ There are some considerations when running macOS via Quickemu.
- UHCI (USB 2.0) on macOS Catalina and earlier. - UHCI (USB 2.0) on macOS Catalina and earlier.
- XHCI (USB 3.0) on macOS Big Sur and newer. - XHCI (USB 3.0) on macOS Big Sur and newer.
- Display resolution can only be changed via macOS System Preferences. - Display resolution can only be changed via macOS System Preferences.
- Full Duplex audio works on macOS High Sierra, Mojave and Catalina. - **Full Duplex audio requires [VoodooHDA
- **macOS Big Sur and Monterey have no audio at all**. 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 - File sharing between guest and host is available via
[virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE
webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
- Copy/paste via SPICE agent is **not available on macOS**. - 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 ## Windows 8.1, 10 & 11 Guests
`quickget` can automatically download Windows 8.1, [Windows `quickget` can automatically download Windows 8.1, [Windows
@ -466,7 +488,6 @@ secureboot="on"
Here are the usage instructions: Here are the usage instructions:
Usage Usage
quickemu --vm ubuntu.conf quickemu --vm ubuntu.conf
@ -502,8 +523,6 @@ Here are the usage instructions:
--extra_args <arguments> : Pass additional arguments to qemu --extra_args <arguments> : Pass additional arguments to qemu
--version : Print version --version : Print version
## Desktop shortcuts ## Desktop shortcuts
Desktop shortcuts can be created for a VM, the shortcuts are saved in Desktop shortcuts can be created for a VM, the shortcuts are saved in

23
docs/quickemu_conf.1
View file

@ -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 .\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font. .\" that render this, and otherwise B font.
@ -14,7 +14,7 @@
. ftr VB CB . ftr VB CB
. ftr VBI CBI . 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 .hy
.SH NAME .SH NAME
.PP .PP
@ -207,12 +207,29 @@ In the example above:
Port 8123 on the host is forwarded to port 8123 on the guest. Port 8123 on the host is forwarded to port 8123 on the guest.
.IP \[bu] 2 .IP \[bu] 2
Port 8888 on the host is forwarded to port 80 on the guest. 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 .SH Bridged networking
.PP .PP
Connect your virtual machine to a preconfigured network bridge. Connect your virtual machine to a preconfigured network bridge.
Add an additional line to your virtual machine configuration Add an additional line to your virtual machine configuration
.IP \[bu] 2 .IP \[bu] 2
\f[V]bridge=\[dq]br0\[dq]\f[R] \f[V]network=\[dq]br0\[dq]\f[R]
.SH USB redirection .SH USB redirection
.PP .PP
Quickemu supports USB redirection via SPICE pass-through and host Quickemu supports USB redirection via SPICE pass-through and host

23
docs/quickemu_conf.1.md
View file

@ -1,6 +1,6 @@
--- ---
author: Martin Wimpress author: Martin Wimpress
date: August 1, 2022 date: August 19, 2022
footer: quickemu_conf footer: quickemu_conf
header: Quickemu Configuration Manual header: Quickemu Configuration Manual
section: 1 section: 1
@ -180,12 +180,31 @@ In the example above:
- Port 8123 on the host is forwarded to port 8123 on the guest. - 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. - 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 # Bridged networking
Connect your virtual machine to a preconfigured network bridge. Add an Connect your virtual machine to a preconfigured network bridge. Add an
additional line to your virtual machine configuration additional line to your virtual machine configuration
- `bridge="br0"` - `network="br0"`
# USB redirection # USB redirection

37
docs/quickget.1
View file

@ -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 .\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font. .\" that render this, and otherwise B font.
@ -14,7 +14,7 @@
. ftr VB CB . ftr VB CB
. ftr VBI CBI . ftr VBI CBI
.\} .\}
.TH "QUICKGET" "1" "August 1, 2022" "quickget" "Quickget User Manual" .TH "QUICKGET" "1" "August 19, 2022" "quickget" "Quickget User Manual"
.hy .hy
.SH NAME .SH NAME
.PP .PP
@ -184,6 +184,8 @@ All the official Ubuntu flavours are supported, just replace
.IP \[bu] 2 .IP \[bu] 2
\f[V]popos\f[R] (Pop!_OS) \f[V]popos\f[R] (Pop!_OS)
.IP \[bu] 2 .IP \[bu] 2
\f[V]reactos\f[R] (ReactOS)
.IP \[bu] 2
\f[V]regolith\f[R] (Regolith Linux) \f[V]regolith\f[R] (Regolith Linux)
.IP \[bu] 2 .IP \[bu] 2
\f[V]rockylinux\f[R] (Rocky Linux) \f[V]rockylinux\f[R] (Rocky Linux)
@ -369,17 +371,40 @@ XHCI (USB 3.0) on macOS Big Sur and newer.
.IP \[bu] 2 .IP \[bu] 2
Display resolution can only be changed via macOS System Preferences. Display resolution can only be changed via macOS System Preferences.
.IP \[bu] 2 .IP \[bu] 2
Full Duplex audio works on macOS High Sierra, Mojave and Catalina. \f[B]Full Duplex audio requires VoodooHDA
.RS 2 OC (https://github.com/chris1111/VoodooHDA-OC) or pass-through a USB
audio-device to the macOS guest VM\f[R].
.IP \[bu] 2 .IP \[bu] 2
\f[B]macOS Big Sur and Monterey have no audio at all\f[R]. NOTE!
.RE 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 .IP \[bu] 2
File sharing between guest and host is available via File sharing between guest and host is available via
virtio-9p (https://wiki.qemu.org/Documentation/9psetup) and SPICE virtio-9p (https://wiki.qemu.org/Documentation/9psetup) and SPICE
webdavd (https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). webdavd (https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
.IP \[bu] 2 .IP \[bu] 2
Copy/paste via SPICE agent is \f[B]not available on macOS\f[R]. 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 .SS Windows 8.1, 10 & 11 Guests
.PP .PP
\f[V]quickget\f[R] can automatically download Windows 8.1, Windows \f[V]quickget\f[R] can automatically download Windows 8.1, Windows

28
docs/quickget.1.md
View file

@ -1,6 +1,6 @@
--- ---
author: Martin Wimpress author: Martin Wimpress
date: August 1, 2022 date: August 19, 2022
footer: quickget footer: quickget
header: Quickget User Manual header: Quickget User Manual
section: 1 section: 1
@ -127,6 +127,7 @@ with your preferred flavour.
- `opensuse` (openSUSE) - `opensuse` (openSUSE)
- `oraclelinux` (Oracle Linux) - `oraclelinux` (Oracle Linux)
- `popos` (Pop!\_OS) - `popos` (Pop!\_OS)
- `reactos` (ReactOS)
- `regolith` (Regolith Linux) - `regolith` (Regolith Linux)
- `rockylinux` (Rocky Linux) - `rockylinux` (Rocky Linux)
- `slackware` (Slackware) - `slackware` (Slackware)
@ -239,13 +240,34 @@ There are some considerations when running macOS via Quickemu.
- UHCI (USB 2.0) on macOS Catalina and earlier. - UHCI (USB 2.0) on macOS Catalina and earlier.
- XHCI (USB 3.0) on macOS Big Sur and newer. - XHCI (USB 3.0) on macOS Big Sur and newer.
- Display resolution can only be changed via macOS System Preferences. - Display resolution can only be changed via macOS System Preferences.
- Full Duplex audio works on macOS High Sierra, Mojave and Catalina. - **Full Duplex audio requires [VoodooHDA
- **macOS Big Sur and Monterey have no audio at all**. 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 - File sharing between guest and host is available via
[virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE [virtio-9p](https://wiki.qemu.org/Documentation/9psetup) and [SPICE
webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24). webdavd](https://gitlab.gnome.org/GNOME/phodav/-/merge_requests/24).
- Copy/paste via SPICE agent is **not available on macOS**. - 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 ## Windows 8.1, 10 & 11 Guests
`quickget` can automatically download Windows 8.1, [Windows `quickget` can automatically download Windows 8.1, [Windows