Marown/quickemu
1
0
Fork 0
mirror of https://github.com/quickemu-project/quickemu.git synced 2024-07-02 03:25:52 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Martin Wimpress 2021-10-19 17:37:59 +01:00 committed by Martin Wimpress
parent 62b7713a6d
commit b7fcb954d4
1 changed files with 21 additions and 68 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

89
README.md
View File

@ -31,10 +31,8 @@ comprehensive support for macOS and Windows**.
* **macOS** High Sierra, Mojave, Catalina and Big Sur
* **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)**
* [elementary OS](https://elementary.io/) (only with SPICE)
* [Fedora](https://getfedora.org/) & openSUSE ([Leap](https://get.opensuse.org/leap/), [Tumbleweed](https://get.opensuse.org/tumbleweed/),[MicroOS](https://microos.opensuse.org/))
* [Linux Mint](https://linuxmint.com/) (Cinnamon, MATE, and XFCE)
* [Pop!_OS](https://pop.system76.com/) (only with SPICE)
* [Fedora](https://getfedora.org/) & openSUSE ([Leap](https://get.opensuse.org/leap/), [Tumbleweed](https://get.opensuse.org/tumbleweed/), [MicroOS](https://microos.opensuse.org/))
* [Linux Mint](https://linuxmint.com/) (Cinnamon, MATE, and XFCE), [elementary OS](https://elementary.io/), [Pop!_OS](https://pop.system76.com/)
* 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
@ -85,7 +83,8 @@ See this (old) video where I explain some of my motivations for creating Quickem
## Ubuntu
Quickemu is available from a PPA for Ubuntu users. The Quickemu PPA also
includes a back port of QEMU 6.0.0 for 20.04 (Focal) and 21.04 (Hirsute).
includes a back port of QEMU 6.0.0 for 20.04 (Focal) and 21.04 (Hirsute). To
install Quickemu and all the dependencies run the following in a terminal:
```bash
sudo apt-add-repository ppa:flexiondotorg/quickemu
@ -99,6 +98,8 @@ git clone --depth=1 https://github.com/wimpysworld/quickemu
cd quickemu
```
Now install all the **Requirements** documented above.
# Usage
## Graphical User Interfaces
@ -110,7 +111,7 @@ While `quickemu` and `quickget` are designed for the terminal, graphical user in
## Ubuntu Guest
`quickget` will automatically download an Ubuntu release and also create the
`quickget` will automatically download an Ubuntu release and create the
virtual machine configuration.
```bash
@ -151,7 +152,19 @@ preferred flavour.
* `ubuntu-studio`
* `xubuntu`
## Linux Guest
## Other Linux Guests
`quickget` also supports:
* `elementary`
* `fedora`
* `linuxmint-cinnamon`
* `linuxmint-mate`
* `linuxmint-xfce`
* `opensuse`
* `popos`
Or you can download a Linux image and manually create a VM configuration.
* Download a .iso image of a Linux distribution
* Create a VM configuration file; for example `debian-bullseye.conf`
@ -290,75 +303,15 @@ tpm="on"
* `fixed_iso=` specifies the ISO image that provides VirtIO drivers.
* `tpm="on"` instructs `quickemu` to create a software emulated TPM device using `swtpm`.
## elementary OS Guest
`quickemu` supports elementary OS, but only installs using SPICE.
```bash
quickget elementary 6_0
quickemu --vm elemenrary-6_0.conf --display spice
```
## FreeBSD Guest
`quickemu` supports FreeBSD production releases. FreeBSD support is maintained by `<kai@potabi.com>`.
`quickemu` supports FreeBSD production releases.
```bash
quickget freebsd 13_0
quickemu --vm freebsd-13_0.conf
```
## Fedora Guest
`quickemu` supports Fedora releases.
```bash
quickget fedora 34
quickemu --vm fedora-34.conf
```
## linuxmint Guest
`quickemu` supports linuxmint releases.
```bash
quickget linuxmint mate-20_2
quickemu --vm linuxmint-mate-20.2.conf
```
## openSUSE Guest
`quickemu` supports openSUSE Leap, Tumbleweed and MicroOS.
For the installation to complete properly, on the "Installation Settings" screen,
you need to disable the "Update NVRAM" option.
On that same screen, you may also want to enable SSH, and open the SSH port.
```bash
quickget opensuse 15_3
quickemu --vm opensuse-15_3.conf
```
```bash
quickget opensuse tumbleweed
quickemu --vm opensuse-tumbleweed
```
```bash
quickget opensuse microos
quickemu --vm opensuse-microos
```
## Pop!_OS Guest
`quickemu` supports Pop!_OS 21.04, but only installs with SPICE.
```bash
quickget popos 21_04
quickemu --vm popos-21_04.conf --display spice
```
# SPICE
The following features are available while using the SPICE protocol: