diff --git a/deploy/medium.md b/deploy/medium.md index c0a62e9..33ca236 100644 --- a/deploy/medium.md +++ b/deploy/medium.md @@ -39,7 +39,7 @@ dd bs=4MB if=~/Downloads/Fedora-Server-dvd-x86_64-38-1.6 of=/dev/sdz The instructions are designed with Etcher in mind. Other tools such as [Rufus](https://rufus.ie/en/), [Unetbootin](https://unetbootin.github.io/) or [Ventoy](https://www.ventoy.net/en/index.html) are likely to work too. -> Etcher is an open-source, cross platform tool for flashing images to a target medium. It is developed and made available by [balena](https://www.balena.io/). +> Etcher is an open-source, cross platform tool for flashing images to a target medium. It is developed and made available by [balena](https://www.balena.io/) {.is-info} #### Install Etcher @@ -50,7 +50,7 @@ Pick the right version depending on your platform. Follow the normal procedure to install an application on your computer. -> An account with administrator rights will be needed. +> An account with administrator rights will be needed {.is-info} #### Use it @@ -69,7 +69,7 @@ Follow the normal procedure to install an application on your computer. ![capture-balenaetcher-3.png](/assets/balena-etcher/capture-balenaetcher-3.png) -* Select *Flash* when you are ready +* Select *Flash* when you are ready. > **Warning:** clicking *Flash* will **destroy** any data on the target device {.is-danger} @@ -79,7 +79,7 @@ Follow the normal procedure to install an application on your computer. ![capture-balenaetcher-4.png](/assets/balena-etcher/capture-balenaetcher-4.png) -* Wait a few minutes... +* Wait for a few minutes... ![capture-balenaetcher-5.png](/assets/balena-etcher/capture-balenaetcher-5.png) diff --git a/getstarted/reactos.md b/getstarted/reactos.md index 37e2338..f07c8ab 100644 --- a/getstarted/reactos.md +++ b/getstarted/reactos.md @@ -10,38 +10,35 @@ 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. +[ReactOS](https://reactos.org/) is an open-source operating system meant to behave 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. +In theory, it can run any software and work with any drivers developed for these older versions of Windows. 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). +Support for the more modern PCI-Express-enabled Q35 chipset, UEFI or virtio-devices is still lacking in ReactOS. Performance of the display won't be optimal, resulting in screen tearing. {.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 | - +| *[Platform firmware](/virt/vm/firmware)* | SeaBIOS [^1] | SeaBIOS | +| *[virtio-gpu](/virt/vm/virtio)* | No | No | +| *[virtio-video](/virt/vm/virtio)* | No | No | +| *[virtio-snd](/virt/vm/virtio)* | No | No | +| *[virtio-blk](/virt/vm/virtio)* | No | No | +| *[virtio-scsi](/virt/vm/virtio)* | No | No | +| *[virtio-fs](/virt/vm/virtio)* | No | No | +| *[virtio-net](/virt/vm/virtio)* | No | **Yes** [^2] | +| *[virtio-keyboard](/virt/vm/virtio)* | No | No | +| *[virtio-tablet](/virt/vm/virtio)* | 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. +> ReactOS itself 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: @@ -52,158 +49,155 @@ There are basically three steps you need to make before you can use this binary- ### Download -* *Go fetch the latest build of the *Boot CD* version of ReactOS on the official website*: https://reactos.org/getbuilds/ +* 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. +> Alternatively, the latest stable release could be downloaded {.is-info} -* *Unzip it using p7zip* (`dnf install p7zip`). +* 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/` +* Copy the resulting ISO under `/var/lib/libvirt/isos/` ``` -mv reactos-bootcd-0.4.15-dev-3628-ga6bf77e-x86-gcc-lin-dbg /var/lib/libvirt/images/ +mv reactos-bootcd-0.4.15-dev-3628-ga6bf77e-x86-gcc-lin-dbg /var/lib/libvirt/isos/ ``` ### Launch the installer -* *[Clone]() the `legacy model` of virtual machine and, optionally, [rename]() it* +* 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* +* 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. +> As of 2022, a full installation of ReactOS takes around 750MB of disk space {.is-info} -* *[Power-on the virtual machine]()* +* Power-on the virtual machine and connect to the console. -* *[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. +{.is-info} -* *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.* ![reactos_installation-0.png](/assets/reactos/reactos_installation-0.png) > The installer supports navigation using the keyboard only. {.is-info} -* *Choose the language for the installation process, using the keyboard Arrows Keys* +* Choose the language for the installation process, using the keyboard Arrows Keys. ![reactos_installation-1.png](/assets/reactos/reactos_installation-1.png) -* *Press ENTER* +* Press ENTER. ![reactos_installation-2.png](/assets/reactos/reactos_installation-2.png) -* *Press ENTER once again* +* Press ENTER once again. ![reactos_installation-3.png](/assets/reactos/reactos_installation-3.png) -* *Navigate to "Accept these device settings" and press ENTER* +* Navigate to "Accept these device settings" and press ENTER. ![reactos_installation-4.png](/assets/reactos/reactos_installation-4.png) -* *Press ENTER again to select the Unpartitionned space* +* Press ENTER again to select the Unpartitionned space. ![reactos_installation-5.png](/assets/reactos/reactos_installation-5.png) -* *Press ENTER to select the FAT file-system.* +* Press ENTER to select the FAT file-system. ![reactos_installation-6.png](/assets/reactos/reactos_installation-6.png) -> *Amazingly, the [BTRFS](https://en.wikipedia.org/wiki/Btrfs) file system is also supported.* -{.is-info} - -* *Press ENTER again to format the targeted partition using the selected file system.* +* Press ENTER again to format the targeted partition using the selected file system. ![reactos_installation-7.png](/assets/reactos/reactos_installation-7.png) -* *Once the formatting is done, press ENTER again to install ReactOS to the selected disk* +* Once the formatting is done, press ENTER again to install ReactOS to the selected disk. ![reactos_installation-8.png](/assets/reactos/reactos_installation-8.png) -* *Wait for the setup to complete. It is fast, so there won't be enough time for a coffee.* +* Wait for the setup to complete. It is likely to be quick, so there won't be enough time for a coffee. ![reactos_installation-9.png](/assets/reactos/reactos_installation-9.png) -* *Once the setup is done, install the bootloader on the hard disk. The default choice seems fine. Press ENTER to reach the next step.* +* Once the setup is done, install the bootloader on the hard disk. The default choice seems fine. Press ENTER to reach the next step. ![reactos_installation-10.png](/assets/reactos/reactos_installation-10.png) -* *The installation is done, wait a few seconds or press ENTER to force the system to reboot right away.* +* The installation is done, wait a few seconds or press ENTER to force the system to reboot right away. ![reactos_installation-11.png](/assets/reactos/reactos_installation-11.png) ### Go through the first boot and initial setup -* *Freeloader: ReactOS' bootloader in all its glory. Wait a few seconds or press ENTER to start ReactOS* +* Freeloader: ReactOS' bootloader in all its glory. Wait a few seconds or press ENTER to start ReactOS. ![reactos_boot-1.png](/assets/reactos/reactos_boot-1.png) -* *Some devices will be automatically installed. Wait a few seconds...* +* Some devices will be automatically installed. Wait for a few seconds... ![reactos_boot-2.png](/assets/reactos/reactos_boot-2.png) > Starting now, your mouse can be used to navigate around. {.is-info} -* *The first boot Wizard for ReactOS should eventually appear. Press ENTER or click on* "Next" +* The first boot wizard for ReactOS should eventually appear. Press ENTER or click on *Next*. ![reactos_boot-3.png](/assets/reactos/reactos_boot-3.png) -* *ReactOS relies on other Open Source projets to function, which it takes time to acknowledge. Press ENTER or click on "Next"* +* ReactOS relies on other open-source projets to function. The license has to be accepted. Press ENTER or click on *Next*. ![reactos_boot-4.png](/assets/reactos/reactos_boot-4.png) -* *ReactOS can behave as a server or as a workstation. If you are unsure, choose workstation. Press ENTER or click on "Next"* +* ReactOS can behave as a server or as a workstation. If you are unsure, choose workstation. Press ENTER or click on *Next*. ![reactos_boot-5.png](/assets/reactos/reactos_boot-5.png) -* *The system language and local can be customized here. If you are satisfied with the default settings, press ENTER or click on "Next". Otherwise, please modify the settings.* +* The system language and local can be customized here. If you are satisfied with the default settings, press ENTER or click on *Next*. Otherwise, please modify the settings. ![reactos_boot-6.png](/assets/reactos/reactos_boot-6.png) -* *Pick a username and, optionaly, an organization, then press ENTER or click on "Next" to go to the next screen.* +* Pick a username and, optionaly, an organization, then press ENTER or click on "Next" to go to the next screen. ![reactos_boot-8.png](/assets/reactos/reactos_boot-8.png) -* *Choose an administrator password, and possibly a computer name, then press ENTER or click on "Next" to go to the next screen.* +* Choose an administrator password, and possibly a computer name, then press ENTER or click on "Next" to go to the next screen. ![reactos_boot-10.png](/assets/reactos/reactos_boot-10.png) -* *Make sure you pick the right timezone then press ENTER or click on "Next" to go to the next screen.* +* Make sure you pick the right timezone then press ENTER or click on "Next" to go to the next screen. ![reactos_boot-11.png](/assets/reactos/reactos_boot-11.png) -* *You can pick the theme of your liking. Press ENTER or click on "Next" to go to the next screen when you are done.* +* You can pick the theme of your liking. Press ENTER or click on "Next" to go to the next screen when you are done. ![reactos_boot-12.png](/assets/reactos/reactos_boot-12.png) -* *Here, you should not have to configure anything for ReactOS to have LAN and Internet access, through the newly supported `virtio-net` device. Press ENTER or click on "Next" to go to the next screen.* +* Here, you should not have to configure anything for ReactOS to have LAN and Internet access, through the newly supported `virtio-net` device. Press ENTER or click on "Next" to go to the next screen. ![reactos_boot-13.png](/assets/reactos/reactos_boot-13.png) -* *If you wish to share files with other computers on your network, joining a Workgroup would be a first step. Press ENTER 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 ENTER or click on "Next" to go to the next screen. ![reactos_boot-14.png](/assets/reactos/reactos_boot-14.png) -* *That's it. Press ENTER or click on "Finish" to reboot your computer.* +* That's it. Press ENTER or click on "Finish" to reboot your computer. ![reactos_boot-15.png](/assets/reactos/reactos_boot-15.png) ### Go through the first boot and initial setup -* *Take a few seconds to admire great splash screen* +* Take a few seconds to admire splash screen. ![reactos_first-boot-1.png](/assets/reactos/reactos_first-boot-1.png) -* *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.* +* 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. ![reactos_first-boot-2.png](/assets/reactos/reactos_first-boot-2.png) -* *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* +* 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. ![reactos_first-boot-3.png](/assets/reactos/reactos_first-boot-3.png)