clean-up
reorganize the wiki using only two-levels of directories
This commit is contained in:
lukas
28
getstarted/darwin.md
Normal file
28
getstarted/darwin.md
Normal file
@@ -0,0 +1,28 @@
|
||||
---
|
||||
title: Darwin family
|
||||
description:
|
||||
published: true
|
||||
date: 2021-11-14T18:41:52.601Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2021-11-13T16:29:34.112Z
|
||||
---
|
||||
|
||||
> Section under construction
|
||||
{.is-warning}
|
||||
|
||||
# Darwin-based operating systems
|
||||
|
||||
> Phyllome OS **strongly** discourages users from virtualizing proprietary, darwin-based operating systems on non-Apple hardware. The Phyllome OS Project will take any possible measures to shutdown threads that mention such setup on platforms it has control over.
|
||||
{.is-danger}
|
||||
|
||||
> That being said, it is perfectly legal to virtualize open-source, darwin-based operating systems surch as [PureDarwin](https://www.puredarwin.org/), even on non-Apple hardware. As a result, Phyllome OS **strongly** encourage users to do so.
|
||||
{.is-info}
|
||||
|
||||
## Introduction
|
||||
|
||||
`to be done`
|
||||
|
||||
---
|
||||
|
||||
*[**Go to parent page**](https://wiki.phyllo.me/)*
|
||||
@@ -1,66 +0,0 @@
|
||||
---
|
||||
title: Get started with Phyllome OS
|
||||
description:
|
||||
published: true
|
||||
date: 2022-07-28T01:06:37.558Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2021-11-13T11:37:31.498Z
|
||||
---
|
||||
|
||||
# How to use Phyllome OS
|
||||
|
||||
*This section explains how to further configure Phyllome OS and how to use in a general sense.*
|
||||
|
||||
* TLDR: [Install a guest operating system](https://wiki.phyllo.me/gofurther#install-a-guest-operating-system)
|
||||
|
||||
## Post-installation configuration
|
||||
|
||||
After Phyllome OS [has been successfully installed](/deploy/install) and [its first-launch process completed](/deploy/install#first-launch), a few tasks are required before it can be used to its fullest potential.
|
||||
|
||||
> As Phyllome OS evolves, the following post-installation configuration will, hopefully, be made obsolete
|
||||
{.is-info}
|
||||
|
||||
### Grant the current user the ability to manage system-based virtual machines
|
||||
|
||||
Any new user, including the one that has been created during the first-launch set up, won't be part of the `libvirt` group. It means that it won't be able to manage the *qemu:///system*, which runs `libvirt` as root.
|
||||
|
||||
To avoid a password prompt each time you connect to *qemu:///system*, you can add the current user to the `libvirt` by using the following command, in the terminal:
|
||||
|
||||
```
|
||||
sudo usermod -a -G libvirt $(whoami)
|
||||
```
|
||||
|
||||
> Phyllome OS will eventually switch to the *qemu:///session* URI, which doesn't require elevated privileges. Have a look at [this great blog post](https://blog.wikichoon.com/2016/01/qemusystem-vs-qemusession.html) to understand some of the differences between the *session* and the *system* URI.
|
||||
{.is-info}
|
||||
|
||||
### Update GRUB and reboot
|
||||
|
||||
Unfortunately, the GRUB config won't correctly update during the kickstart phase, so it has to be done manually.
|
||||
|
||||
```
|
||||
sudo grub2-mkconfig -o /boot/grub2/grub.cfg
|
||||
```
|
||||
When the is done, please reboot: `sudo reboot`
|
||||
|
||||
### Modify the system allocated to the GPU in the BIOS/UEFI (vfio-mdev only)
|
||||
|
||||
> Some computers allow you to modify the system memory allocated or shared with the integrated GPU, which may allow you to create more vGPUs.
|
||||
{.is-info}
|
||||
|
||||
> For Intel integrated graphics cards only; rarely available on laptops computers.
|
||||
{.is-warning}
|
||||
|
||||
* Before the host operating system boots up, you need to enter the BIOS/UEFI and to look for a setting called *GPU aperture size*, or *GPU shared memory*.
|
||||
|
||||
* Use the highest possible value.
|
||||
|
||||
> System memory will be reserved for the GPU, so make sure you have enough system memory to accomodate both the GPU and your operating system.
|
||||
{.is-warning}
|
||||
|
||||
|
||||
---
|
||||
|
||||
*Are you looking for tasks to do with your system? If so, have a look at doing some [suggested tasks](/gofurther)*
|
||||
|
||||
[^1]: Although, we very much encourage you to [hack it](https://github.com/PhyllomeOS/phyllomeos#how-to-hack-phyllome-os).
|
||||
90
getstarted/install-guest.md
Normal file
90
getstarted/install-guest.md
Normal file
@@ -0,0 +1,90 @@
|
||||
---
|
||||
title: Netboot for all
|
||||
description:
|
||||
published: true
|
||||
date: 2021-11-25T13:58:10.457Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2021-11-13T11:43:58.697Z
|
||||
---
|
||||
|
||||
# Use a live guest OS
|
||||
|
||||
As of now, `netboot.xyz` is one of the main way to deploy or use a guest operating system inside Phyllome OS. It is compatible with most (but not all) guest operating systems. This small guide will show you how to deploy a live system inside Phyllome OS.
|
||||
|
||||
## Preparation
|
||||
|
||||
By default, `netboot.xyz.iso` should already be located under `var/lib/libvirt/iso`. If it's not the case, please use the following command to fetch it, or navigate to [the website](https://netboot.xyz/):
|
||||
|
||||
```
|
||||
wget https://boot.netboot.xyz/ipxe/netboot.xyz.iso -P /var/lib/libvirt/iso/
|
||||
```
|
||||
## Run the script
|
||||
|
||||
The following script, which also doesn't require root privileges, will create a virtual machine called `my-first-live-vm`. This virtual machine will be started automatically and added to `virt-manager`.
|
||||
|
||||
```
|
||||
/usr/sbin/create-live-vm.sh
|
||||
```
|
||||
*Notice the new icon under QEMU/KVM: this is the new virtual machine that has just been created. Go to the section to learn how to interact with it.*
|
||||
|
||||
|
||||
|
||||
## Access your virtual machine display
|
||||
|
||||
* Double-click on *my-first-live-vm* to open its virtual display, then click on *Connect to console*.
|
||||
|
||||
|
||||
|
||||
> Phyllome OS ships with a small ISO crafted by the team behind [netboot.xyz](https://netboot.xyz/), and that can do network boot, allowing it to do network-based installations of the most popular Linux distributions, among other niceties.
|
||||
{.is-info}
|
||||
|
||||
|
||||
|
||||
* After a few seconds, you will be greeted by the following screen.
|
||||
|
||||
|
||||
|
||||
* Under the menu, go to *View* and select *Full Screen*
|
||||
|
||||
|
||||
|
||||
* Go to *Live CDs*
|
||||
|
||||
> There is no disk attached to this virtual machine. As a result, only Live CDs will work out-the-box.
|
||||
{.is-info}
|
||||
|
||||
|
||||
|
||||
* Scroll down this list
|
||||
|
||||
|
||||
|
||||
* Stop at *Tiny Core Linux* and press <kbd>Enter</kbd>
|
||||
|
||||
|
||||
|
||||
* Select *Tiny Core Linux x86_64*
|
||||
|
||||
|
||||
|
||||
* Select *Tiny Core Linux CorePure*
|
||||
|
||||
|
||||
|
||||
* Enjoy your disposable virtual machine
|
||||
|
||||
|
||||
|
||||
* When you are done messing around, input the following, and you will be back in Phyllome OS
|
||||
|
||||
```
|
||||
sudo poweroff
|
||||
```
|
||||
|
||||
> That's it, congratulations!
|
||||
{.is-success}
|
||||
|
||||
---
|
||||
|
||||
*[**Go to parent page**](https://wiki.phyllo.me/)*
|
||||
@@ -1,60 +0,0 @@
|
||||
---
|
||||
title: Get started with the Live system
|
||||
description:
|
||||
published: true
|
||||
date: 2021-11-22T20:54:09.582Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2021-11-13T11:36:55.647Z
|
||||
---
|
||||
|
||||
# Phyllome OS as a live system
|
||||
|
||||
> Phyllome OS is not production-ready, let alone ready to be used daily as a live system.
|
||||
{.is-warning}
|
||||
|
||||
Using Phyllome OS as a live system is a great way to test it out and make sure your host computer is up to the task, before committing to a [permanent installation](/deploy/live), which is currently the recommended way to use Phyllome OS.
|
||||
|
||||
Under certain conditions, you may want to use a live system daily, provided that the disk and [XML configuration](/virt/xml) of your virtual machine disks are stored outside the USB thumb drive.
|
||||
|
||||
## Boot from a USB flash drive
|
||||
|
||||
By default, when a computer boots up, it will look for an operating system on the internal storage device first. If there is one, it will load this operating system and ignore any other media, such as any USB flash drive that may be plugged to the computer.
|
||||
|
||||
To boot from a USB flash drive, one would have to either temporary or permanently alter the so-called boot order. The boot order instructs at what point and where it should look for an operating system. The following section illustrates how to change the boot order *temporary*.
|
||||
|
||||
> The process to change the boot order depends on your current computer platform. Please follow the instruction that matches your platform.
|
||||
{.is-info}
|
||||
|
||||
> Booting from a USB flash drive is a **non-destructive** process, which means that it won't affect any pre-existing operating system that may be installed on your computer. As a precautious, it may be good to backup your data or, even better, to use a computer with no personnal data on it.
|
||||
{.is-info}
|
||||
|
||||
### macOS
|
||||
|
||||
* Make sure that your computer is turned-off.
|
||||
* Locate the <kbd>Alt</kbd> / <kbd>Option</kbd> key on your keyboard.
|
||||
* Turn your computer on and immediately press the <kbd>Alt</kbd> / <kbd>Option</kbd> key continuously.
|
||||
* The startup manager should appear after a few seconds.
|
||||
* Click on the option called *EFI* to boot Phyllome OS.
|
||||
|
||||
> Other Mac startup key combinations can be found [here](https://support.apple.com/en-us/HT201255).
|
||||
{.is-info}
|
||||
|
||||
### Windows 8 and later versions
|
||||
|
||||
> Section under construction
|
||||
{.is-warning}
|
||||
|
||||
### Other computers
|
||||
|
||||
> Section under construction
|
||||
{.is-warning}
|
||||
|
||||
## Use it daily
|
||||
|
||||
> At the moment, changes applied to a Phyllome OS Live medium do not persist across reboots.
|
||||
{.is-info}
|
||||
|
||||
---
|
||||
|
||||
*Are you looking for things to do with your live system? If so, have a look at doing some [suggested tasks](/gofurther)*
|
||||
226
getstarted/reactos.md
Normal file
226
getstarted/reactos.md
Normal file
@@ -0,0 +1,226 @@
|
||||
---
|
||||
title: ReactOS
|
||||
description:
|
||||
published: true
|
||||
date: 2022-01-20T13:26:23.710Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2021-11-13T11:52:33.257Z
|
||||
---
|
||||
|
||||
# ReactOS
|
||||
|
||||
[ReactOS](https://reactos.org/) is an open-source operating system meant to behave exactly like Windows XP, Windows Server 2003 and later versions of Windows.
|
||||
|
||||
In theory, it can run any software and work with any drivers developed for these older versions of Windows. Decades old software or pieces of equipments that no longer ship with drivers to run with the latest iterations of the Windows operating system may work with ReactOS.
|
||||
|
||||
In practice, it is still under heavy-development and may not work as expected.
|
||||
|
||||
## State of support
|
||||
|
||||
Support for the more modern PCI-Express-enabled Q35 chipset, UEFI or other virtio-devices, which Phyllome OS favors, is still lacking in ReactOS. Performance of the display won't be optimal, resulting in screen tearing. More information can be found [here](/virt/guest/reactos).
|
||||
{.is-warning}
|
||||
|
||||
| **Hardware** | ReactOS 4.13 | ReactOS 4.14 |
|
||||
| :- | :-: | :-: |
|
||||
| *[Chipset](/virt/vm/chipset)* | i440fx | i440fx |
|
||||
| *Firmware* | SeaBIOS [^1] | SeaBIOS |
|
||||
| *virtio-gpu* | No | No |
|
||||
| *virtio-video* | No | No |
|
||||
| *virtio-snd* | No | No |
|
||||
| *virtio-blk* | No | No |
|
||||
| *virtio-scsi* | No | No |
|
||||
| *virtio-fs* | No | No |
|
||||
| *virtio-net* | No | **Yes** [^2] |
|
||||
| *virtio-keyboard* | No | No |
|
||||
| *virtio-tablet* | No | No |
|
||||
|
||||
|
||||
> Porting new paravirtual devices to ReactOS would significantly improve the experience of running ReactOS inside Phyllome OS, and other virtualization solutions leveraging [paravirtual hardware](https://wiki.phyllo.me/e/en/virt/virtio). See [here](https://reactos.org/contributing/) on how you can contribute to ReactOS
|
||||
{.is-info}
|
||||
|
||||
## Installation
|
||||
|
||||
> ReactOS is currently in **Alpha stage** and not production ready.
|
||||
{.is-warning}
|
||||
|
||||
There are basically three steps you need to make before you can use this binary-compatible and open-source replica of Windows:
|
||||
|
||||
* Download a medium to install the system
|
||||
* Install the system
|
||||
* Configure the system
|
||||
|
||||
### Download
|
||||
|
||||
* *Go fetch the latest build of the *Boot CD* version of ReactOS on the official website*: https://reactos.org/getbuilds/
|
||||
|
||||
> Alternatively, the latest stable release could be downloaded.
|
||||
{.is-info}
|
||||
|
||||
* *Unzip it using p7zip* (`dnf install p7zip`).
|
||||
|
||||
```
|
||||
7za x reactos-bootcd-0.4.15-dev-3628-ga6bf77e-x86-gcc-lin-dbg.7z
|
||||
```
|
||||
|
||||
* *Copy the resulting ISO under* `/var/lib/libvirt/images/`
|
||||
|
||||
```
|
||||
mv reactos-bootcd-0.4.15-dev-3628-ga6bf77e-x86-gcc-lin-dbg /var/lib/libvirt/images/
|
||||
```
|
||||
|
||||
### Launch the installer
|
||||
|
||||
* *[Clone]() the `legacy model` of virtual machine and, optionally, [rename]() it*
|
||||
|
||||
* *[Add the ISO file]() you just downloaded and [add a disk]() of at least 1GB using the Virtual Machine Manager*
|
||||
|
||||
> As of 2022, a full installation of ReactOS takes around 750Mb.
|
||||
{.is-info}
|
||||
|
||||
* *[Power-on the virtual machine]()*
|
||||
|
||||
* *[Connect to the console]()*
|
||||
|
||||
* *Just as in the good ol' days, you need to press a key to start the installer. Notice the fact that an open firmware, [SeaBIOS](https://www.seabios.org/SeaBIOS), is able to boot an open-source NT-based kernel. A rare sight.*
|
||||
|
||||
|
||||
|
||||
> The installer supports navigation using the keyboard only.
|
||||
{.is-info}
|
||||
|
||||
* *Choose the language for the installation process, using the keyboard Arrows Keys*
|
||||
|
||||
|
||||
|
||||
* *Press <kbd>ENTER</kbd>*
|
||||
|
||||
|
||||
|
||||
* *Press <kbd>ENTER</kbd> once again*
|
||||
|
||||
|
||||
|
||||
* *Navigate to "Accept these device settings" and press <kbd>ENTER</kbd>*
|
||||
|
||||
|
||||
|
||||
* *Press <kbd>ENTER</kbd> again to select the Unpartitionned space*
|
||||
|
||||
|
||||
|
||||
* *Press <kbd>ENTER</kbd> to select the FAT file-system.*
|
||||
|
||||
|
||||
|
||||
> *Amazingly, the [BTRFS](https://en.wikipedia.org/wiki/Btrfs) file system is also supported.*
|
||||
{.is-info}
|
||||
|
||||
* *Press <kbd>ENTER</kbd> again to format the targeted partition using the selected file system.*
|
||||
|
||||
|
||||
|
||||
* *Once the formatting is done, press <kbd>ENTER</kbd> again to install ReactOS to the selected disk*
|
||||
|
||||
|
||||
|
||||
* *Wait for the setup to complete. It is fast, so there won't be enough time for a coffee.*
|
||||
|
||||
|
||||
|
||||
* *Once the setup is done, install the bootloader on the hard disk. The default choice seems fine. Press <kbd>ENTER</kbd> to reach the next step.*
|
||||
|
||||
|
||||
|
||||
* *The installation is done, wait a few seconds or press <kbd>ENTER</kbd> to force the system to reboot right away.*
|
||||
|
||||
|
||||
|
||||
### Go through the first boot and initial setup
|
||||
|
||||
* *Freeloader: ReactOS' bootloader in all its glory. Wait a few seconds or press <kbd>ENTER</kbd> to start ReactOS*
|
||||
|
||||
|
||||
|
||||
* *Some devices will be automatically installed. Wait a few seconds...*
|
||||
|
||||
|
||||
|
||||
> Starting now, your mouse can be used to navigate around.
|
||||
{.is-info}
|
||||
|
||||
* *The first boot Wizard for ReactOS should eventually appear. Press <kbd>ENTER</kbd> or click on* "Next"
|
||||
|
||||
|
||||
|
||||
* *ReactOS relies on other Open Source projets to function, which it takes time to acknowledge. Press <kbd>ENTER</kbd> or click on "Next"*
|
||||
|
||||
|
||||
|
||||
* *ReactOS can behave as a server or as a workstation. If you are unsure, choose workstation. Press <kbd>ENTER</kbd> or click on "Next"*
|
||||
|
||||
|
||||
|
||||
* *The system language and local can be customized here. If you are satisfied with the default settings, press <kbd>ENTER</kbd> or click on "Next". Otherwise, please modify the settings.*
|
||||
|
||||
|
||||
|
||||
* *Pick a username and, optionaly, an organization, then press <kbd>ENTER</kbd> or click on "Next" to go to the next screen.*
|
||||
|
||||
|
||||
|
||||
* *Choose an administrator password, and possibly a computer name, then press <kbd>ENTER</kbd> or click on "Next" to go to the next screen.*
|
||||
|
||||
|
||||
|
||||
* *Make sure you pick the right timezone then press <kbd>ENTER</kbd> or click on "Next" to go to the next screen.*
|
||||
|
||||
|
||||
|
||||
* *You can pick the theme of your liking. Press <kbd>ENTER</kbd> or click on "Next" to go to the next screen when you are done.*
|
||||
|
||||
|
||||
|
||||
* *Here, you should not have to configure anything for ReactOS to have LAN and Internet access, through the newly supported `virtio-net` device. Press <kbd>ENTER</kbd> or click on "Next" to go to the next screen.*
|
||||
|
||||
|
||||
|
||||
* *If you wish to share files with other computers on your network, joining a Workgroup would be a first step. Press <kbd>ENTER</kbd> or click on "Next" to go to the next screen.*
|
||||
|
||||
|
||||
|
||||
* *That's it. Press <kbd>ENTER</kbd> or click on "Finish" to reboot your computer.*
|
||||
|
||||
|
||||
|
||||
### Go through the first boot and initial setup
|
||||
|
||||
* *Take a few seconds to admire great splash screen*
|
||||
|
||||
|
||||
|
||||
* *The system will automatically open a session with the user you created (that is pretty clever, as there is no need to remember the password I already forgot :')). A few windows may open, prompting you to install some devices. Unless you know what you are doing, cancel these prompts to land on the pristine desktop.*
|
||||
|
||||
|
||||
|
||||
* *As already stated, support for the more modern PCI-Express-enabled Q35 chipset, UEFI or other virtio-devices is not yet there. You may still enjoy the ride, try to install these old software that has long been forgotten in a drawer or this decade old printer collecting dust, and that no operating system would dare to interact with anymore*
|
||||
|
||||
|
||||
|
||||
> Congratulations, you have successfully installed ReactOS!
|
||||
{.is-success}
|
||||
|
||||
## Resources
|
||||
|
||||
* [Official resource](https://reactos.org/wiki/QEMU) on running ReactOS with QEMU
|
||||
* [Hardware support list](https://reactos.org/wiki/Supported_Hardware) for ReactOS
|
||||
* [Git repository](https://github.com/hectorm/docker-qemu-reactos) providing a Docker image for the ReactOS operating system
|
||||
* [Current effort](https://github.com/QubesOS/qubes-issues/issues/2809) to integrate ReactOS and QubesOS
|
||||
* [GSoC 2018 project idea](https://reactos.org/wiki/Google_Summer_of_Code_2018_Ideas#Paravirtualization_Support) to port more paravirtualized devices to ReactOS
|
||||
|
||||
[^1]: Support for [UEFI](https://reactos.org/wiki/UEFI), and potentially OVMF, is under-way.
|
||||
[^2]: See [here](https://doxygen.reactos.org/d1/dc8/virtio__types_8h.html#a5a27dcd221caab788e973f6964d84aa9) for the source code reference for `virtio-net`
|
||||
|
||||
---
|
||||
|
||||
*[**Go to parent page**](https://wiki.phyllo.me/)*
|
||||
15
getstarted/windows11.md
Normal file
15
getstarted/windows11.md
Normal file
@@ -0,0 +1,15 @@
|
||||
---
|
||||
title: Windows
|
||||
description:
|
||||
published: true
|
||||
date: 2023-05-19T17:24:19.852Z
|
||||
tags:
|
||||
editor: markdown
|
||||
dateCreated: 2023-05-19T17:24:19.852Z
|
||||
---
|
||||
|
||||
# Windows
|
||||
|
||||
## Resources
|
||||
|
||||
* https://kevinlocke.name/bits/2021/12/10/windows-11-guest-virtio-libvirt/
|
||||
Reference in New Issue
Block a user