mirror of
https://github.com/oSoWoSo/DistroHopper.git
synced 2024-08-14 22:46:53 +00:00
Updated for commits direct to README
This commit is contained in:
Phil Clifford
Martin Wimpress
parent
d669c4ca2a
commit
8bb24f69c0
8 changed files with 228 additions and 90 deletions
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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 <arguments> : Pass additional arguments to qemu
|
||||
--version : Print version
|
||||
|
||||
|
||||
|
||||
## Desktop shortcuts
|
||||
|
||||
Desktop shortcuts can be created for a VM, the shortcuts are saved in
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue