Difference between revisions of "Installing ReactOS"

From ReactOS Wiki
Jump to: navigation, search
(Real hardware)
(Undo revision 51213 by Guzio (talk) and clarify the wording)
(Tag: Undo)
 
(20 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{Warning|Please bear in mind that ReactOS is still in '''alpha stage''', meaning it is not stable or feature-complete and is not recommended for everyday use. Operating system bugs can and do result in corrupted file systems, overwritten partitions, and more. Do not install ReactOS on any computer containing important data without '''using a virtual machine''' or '''making full backups first'''.}}
 
{{Warning|Please bear in mind that ReactOS is still in '''alpha stage''', meaning it is not stable or feature-complete and is not recommended for everyday use. Operating system bugs can and do result in corrupted file systems, overwritten partitions, and more. Do not install ReactOS on any computer containing important data without '''using a virtual machine''' or '''making full backups first'''.}}
  
== Before installing ==
+
= Before installing =
 
There are several things to be made aware of before installing ReactOS, or even obtaining the installation media. These include how ReactOS will be installed, limitations of the installation, and backing up existing data.
 
There are several things to be made aware of before installing ReactOS, or even obtaining the installation media. These include how ReactOS will be installed, limitations of the installation, and backing up existing data.
  
=== Limitations ===
+
== Limitations ==
 
ReactOS is '''[https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha alpha]''' level (or alpha phase) software. It is not yet [https://en.wikipedia.org/wiki/Feature_complete feature complete]. <br>
 
ReactOS is '''[https://en.wikipedia.org/wiki/Software_release_life_cycle#Alpha alpha]''' level (or alpha phase) software. It is not yet [https://en.wikipedia.org/wiki/Feature_complete feature complete]. <br>
 
Some major bugs remain to be corrected.  For the details see [[Known Issues]].
 
Some major bugs remain to be corrected.  For the details see [[Known Issues]].
Line 10: Line 10:
  
  
The ReactOS itself, setup utility and [[FreeLoader|boot loader]] have a number of limitations. The most prominent are:
+
The ReactOS itself, setup utility, and [[FreeLoader|boot loader]] have a number of limitations. The most prominent are:
  
* ReactOS is '''not''' able to boot from '''USB''' devices yet. Except [[User:Illen/RAM_Boot|RAM Boot]] method.
+
* ReactOS is '''not''' able to boot from '''USB''' devices yet. Except [[#USB-RAM boot|RAM Boot]] method.
 
* the setup utility does not prevent users from performing dangerous and potentially destructive operations.
 
* the setup utility does not prevent users from performing dangerous and potentially destructive operations.
 +
* UEFI system firmware is not supported by ReactOS yet, you have to use legacy BIOS mode.
 
* some SATA controllers may not work with ReactOS.
 
* some SATA controllers may not work with ReactOS.
* the boot partition is highly recommended be the first FAT16 or FAT32 partition on the first (or even better - single) disk in the system.
+
* the boot partition is highly recommended to be the first partition on the first (or even better - single) disk in the system.
 
* the setup utility can check the integrity of ONLY FAT16 and FAT32 file systems.
 
* the setup utility can check the integrity of ONLY FAT16 and FAT32 file systems.
* HD Audio or use of multiple audio cards at the same time are not yet supported. ReactOS versions and builds prior 0.4.12 will not boot after setup.
+
* HD Audio or use of multiple audio cards at the same time are not yet supported, ReactOS versions and builds prior to 0.4.12 will not boot after setup with this configuration.
  
== System requirements ==
+
= System requirements =
  
=== Hardware support ===
+
== Hardware support ==
 
ReactOS has '''limited''' hardware support. Lists of particular hardware that have been tested can be found on the page '''[[Supported Hardware]]'''.
 
ReactOS has '''limited''' hardware support. Lists of particular hardware that have been tested can be found on the page '''[[Supported Hardware]]'''.
  
=== Minimum hardware requirements ===
+
== Minimum hardware requirements ==
 
The minimum requirements to install ReactOS are:
 
The minimum requirements to install ReactOS are:
  
Line 33: Line 34:
 
* '''Video:''' VGA compatible video card (VESA BIOS version 2.0 or later).
 
* '''Video:''' VGA compatible video card (VESA BIOS version 2.0 or later).
  
== Getting ReactOS ==
+
= Getting ReactOS =
 
Due to the current state of the project, the ReactOS Foundation does not offer official installation media for distribution. Installation CD-ROMs must be created by the user by writing an available image file to a CD-ROM.
 
Due to the current state of the project, the ReactOS Foundation does not offer official installation media for distribution. Installation CD-ROMs must be created by the user by writing an available image file to a CD-ROM.
  
=== Downloading the image file ===
+
== Downloading the image file ==
 
Official ISO image files can be downloaded at one of the following locations:
 
Official ISO image files can be downloaded at one of the following locations:
* The official [http://www.reactos.org/download Download] page.
+
* The official [https://reactos.org/download Download] page.
* ReactOS [http://www.reactos.org/getbuilds trunk builds]
+
* ReactOS [https://reactos.org/getbuilds daily builds]
* ReactOS at [http://sourceforge.net/projects/reactos/files/ReactOS SourceForge] (ReactOS-{{ReactOS-Curr-Version}}-REL-iso.zip)
+
* ReactOS at [https://sourceforge.net/projects/reactos/files/ReactOS SourceForge] (ReactOS-{{ReactOS-Curr-Version}}-REL-iso.zip)
  
 
WARNING: Some anti-malware programs will detect false positives in ReactOS files.
 
WARNING: Some anti-malware programs will detect false positives in ReactOS files.
  
=== Creating the Installation CD ===
+
== Creating the Installation CD ==
 
The downloaded file is a compressed archive in ZIP format, containing a single file named "ReactOS.iso". The ISO image contains everything needed to create the CD.
 
The downloaded file is a compressed archive in ZIP format, containing a single file named "ReactOS.iso". The ISO image contains everything needed to create the CD.
 
* Extract the image file from the archive into a temporary directory.
 
* Extract the image file from the archive into a temporary directory.
Line 51: Line 52:
 
When burning the ISO to disc, be sure it is written as an image file. Writing to the disc as another type of data will not work and render the Installation CD unbootable. Look for an option similar to "Burn from ISO" or "Write disk image".
 
When burning the ISO to disc, be sure it is written as an image file. Writing to the disc as another type of data will not work and render the Installation CD unbootable. Look for an option similar to "Burn from ISO" or "Write disk image".
  
== Installing ReactOS ==
+
= Installing ReactOS =
 
Please consider '''making full backups''' of any sensitive data before you start any experiments with ReactOS in the production environment!
 
Please consider '''making full backups''' of any sensitive data before you start any experiments with ReactOS in the production environment!
  
=== Installation strategy ===
+
== Installation strategy ==
 
The first consideration to make is whether to install ReactOS on a dedicated testing machine or in a contained environment, such as running on an emulator without direct disk access. The use of an emulator is preferable if the machine on which you will run ReactOS is your primary computer or if you have important data on the computer which you cannot afford to lose.
 
The first consideration to make is whether to install ReactOS on a dedicated testing machine or in a contained environment, such as running on an emulator without direct disk access. The use of an emulator is preferable if the machine on which you will run ReactOS is your primary computer or if you have important data on the computer which you cannot afford to lose.
  
 
If you decide to install ReactOS on a disk drive that contains an existing operating system (such as Microsoft Windows XP), you should ensure that the drive is formatted with a file system ReactOS can access and write to (now, primary FAT32/FAT16 partition) and that there is sufficient free space on the drive such that ReactOS can be installed (now, >=450&nbsp;MB).
 
If you decide to install ReactOS on a disk drive that contains an existing operating system (such as Microsoft Windows XP), you should ensure that the drive is formatted with a file system ReactOS can access and write to (now, primary FAT32/FAT16 partition) and that there is sufficient free space on the drive such that ReactOS can be installed (now, >=450&nbsp;MB).
Furthermore, the current hardware limitations to which ReactOS is constrained must be identified and compared to the target computer system (e.g. that ReactOS has only basic [[USB]] support as of the [[0.4.7]] release).
+
Furthermore, the current hardware limitations to which ReactOS is constrained must be identified and compared to the target computer system (e.g. that ReactOS has only basic audio support as of [[0.4.12]] release).
  
Once the available hardware and software situation is determined the installation media can be selected. For example, if your computer includes an ATA CD-ROM and an IDE hard disk that does not contain irreplaceable data, a good installation option may be to write an ISO image of the ReactOS installation media to a CD-RW and proceed to install ReactOS on the IDE hard disk via the CD-ROM.
+
Once the available hardware and software situation is determined the installation media can be selected. In most cases, USB-RAM boot should be enough (or CD-ROM boot for virtual machines). But sometimes it may either not work or be not available for the particular system. Then you can use other available options as well.
  
 
ReactOS goes through three stages during setup. The first two stages deal with the installation of the system, while the third stage is the first usable boot by the user.
 
ReactOS goes through three stages during setup. The first two stages deal with the installation of the system, while the third stage is the first usable boot by the user.
 
* First stage – Text mode setup, started when booting from a ReactOS CD-ROM.
 
* First stage – Text mode setup, started when booting from a ReactOS CD-ROM.
* Second stage – Booting to GUI installer. Input of user information and registering of files.
+
* Second stage – Booting to GUI installer. The input of user information and registering of files.
 
* Third stage – Booting to desktop, user configurations.
 
* Third stage – Booting to desktop, user configurations.
  
If you '''encounter problems''', disable all secondary or unnecessary devices, especially '''USB'''-cameras and '''sound cards''' of any type.
+
If you '''encounter problems''', it is recommended to disable all secondary or unnecessary devices, especially '''USB'''-cameras and '''sound cards''' of any type.
  
=== Virtual Machines ===
+
== Virtual Machines ==
 
A Virtual Machine is a software program that provides a virtual hardware platform. Software instructions that would be run on hardware are now interpreted by the emulator software. This allows you to "run" a different kind of computer hardware and its software in a window on your computer.
 
A Virtual Machine is a software program that provides a virtual hardware platform. Software instructions that would be run on hardware are now interpreted by the emulator software. This allows you to "run" a different kind of computer hardware and its software in a window on your computer.
  
 
See article [[Virtualization software]] for the details.
 
See article [[Virtualization software]] for the details.
  
=== Real hardware ===
+
== Real hardware ==
  
 
'''Note''' For the real hardware experiments, we recommend you to use our "official" [https://amzn.to/2okGUuH Dell Latitude D531] laptop or similar [[PC ROS Rigs| notebook models]] in order to achieve the best possible experience.
 
'''Note''' For the real hardware experiments, we recommend you to use our "official" [https://amzn.to/2okGUuH Dell Latitude D531] laptop or similar [[PC ROS Rigs| notebook models]] in order to achieve the best possible experience.
 +
 +
=== Ordinary CD-ROM method ===
  
 
* Make sure your BIOS is configured to boot from the CD-ROM first.
 
* Make sure your BIOS is configured to boot from the CD-ROM first.
 +
* If your PC has UEFI system firmware, then you have to enable legacy BIOS mode.
 
* Insert the ReactOS setup CD-ROM into a CD-ROM drive and reboot your computer. On the next boot, the ReactOS setup utility will start.
 
* Insert the ReactOS setup CD-ROM into a CD-ROM drive and reboot your computer. On the next boot, the ReactOS setup utility will start.
 
* Follow the instructions on the screen to install ReactOS on your computer.
 
* Follow the instructions on the screen to install ReactOS on your computer.
 
* After the installation has finished, remove the setup CD-ROM from the CD-ROM drive and press ''Enter'' to reboot your computer. You can now start ReactOS by selecting it from the boot menu.
 
* After the installation has finished, remove the setup CD-ROM from the CD-ROM drive and press ''Enter'' to reboot your computer. You can now start ReactOS by selecting it from the boot menu.
  
=== Real hardware without CD Drive ===
+
=== USB Installation ===
* create a virtual Machine but without the Harddisk
+
 
* create a virtual Harddisk for Virtualbox which points to the real one.
+
Due to problems with the PnP manager, it is '''NOT''' currently possible to boot or install ReactOS from a '''USB''' stick made directly from *.iso file. You will get BSOD with <code>0x0000007B</code> code. This worked previously but was broken several years ago by a rewrite of the USB code and major changes in the kernel. For USB boot you have to use [[#USB-RAM boot|RAM Boot]] method instead.
** on Linux: VBoxManage internalcommands createrawvmdk -filename "~/VirtualBox VMs/reactos/disk.vmdk" -rawdisk PathToHarddisk
+
 
** important: PathToHarddisk must be the whole disk, not a partition: /dev/sdb
+
You can try applying a patch from [https://github.com/reactos/reactos/pull/1569 PR #1569] and building from source, or try these unofficial experimental builds '''http://vgal.ru.com/reactos-0-4-10-new-usb/''' (not recommended, they are very outdated).
* add disk.vmdk to virtual Machine via Storage->add Harddisk
+
 
* install reactos as usual
+
=== USB-RAM boot ===
 +
For this method, you should prepare a flash drive first. It should have a FAT32 filesystem and the [https://en.wikipedia.org/wiki/Multiboot_specification Multiboot specification]-capable bootloader should be installed on it.
 +
For example, you can use [https://wiki.syslinux.org/wiki/index.php?title=Install syslinux]. Here is how to install it (for syslinux version 6.x):
 +
 
 +
==== On Linux ====
 +
 
 +
Plug in the flash drive and leave it unmounted.
 +
Then run these commands:
 +
<pre>
 +
sudo mkfs.vfat /dev/sdb1
 +
sudo syslinux --install /dev/sdb1
 +
</pre>
 +
Note: here, <code>/dev/sdb1</code> is a partition on a flash drive
 +
 
 +
==== On Windows ====
 +
 
 +
Use [https://rufus.ie/ Rufus] tool:
 +
 
 +
* Select your flash drive
 +
* Click "Show advanced drive properties"
 +
* Boot selection: <code>Syslinux 6.x</code>
 +
* Partition scheme: <code>MBR</code>, File system: <code>FAT32</code>
 +
* Format the drive using selected options above
 +
 
 +
==== Next common steps for both platforms ====
 +
 
 +
At this point, you should have a bootloader installed onto the drive. '''Now it's time to copy some files onto it'''.
 +
 
 +
([https://svn.reactos.org/packages/usbramboot.zip Download] all the required files, except iso images, in a zip-archive. It uses freeldr.sys from the [https://git.reactos.org/?p=reactos.git;a=commit;h=fb4591c48c568d138d9d7aeaa90db4bd5885c6aa fb4591c] commit)
 +
 
 +
* Now you need to copy <code>mboot.c32</code> and <code>libcom32.c32</code> syslinux libraries to the root
 +
* Then copy a freeldr.sys bootloader from ReactOS [[0.4.13]] or higher
 +
* Now you need to write some configuration files. First, <code>syslinux.cfg</code>:
 +
 
 +
<pre>
 +
DEFAULT ReactOS
 +
LABEL ReactOS
 +
  KERNEL mboot.c32
 +
  APPEND /freeldr.sys
 +
</pre>
 +
* Then <code>freeldr.ini</code>:
 +
<pre>
 +
[FREELOADER]
 +
DefaultOS=BootCD_Debug
 +
TimeOut=5
  
=== USB Installation ===
+
[Display]
Due to problems with the USB stack it is '''NOT''' currently possible to install ReactOS from a '''USB''' stick or CD-ROM, the setup process will fail partway through. This worked previously but was broken several years ago by a rewrite of the USB code. See the [[LiveUSB]] page for more details.  
+
TitleText=ReactOS LiveUSB
 +
StatusBarColor=Cyan
 +
StatusBarTextColor=Black
 +
BackdropTextColor=White
 +
BackdropColor=Blue
 +
BackdropFillStyle=Medium
 +
TitleBoxTextColor=White
 +
TitleBoxColor=Red
 +
MessageBoxTextColor=White
 +
MessageBoxColor=Blue
 +
MenuTextColor=Gray
 +
MenuColor=Black
 +
TextColor=Gray
 +
SelectedTextColor=Black
 +
SelectedColor=Gray
 +
ShowTime=No
 +
MenuBox=No
 +
CenterMenu=No
 +
MinimalUI=Yes
 +
TimeText=Seconds until highlighted choice will be started automatically:
 +
 
 +
[Operating Systems]
 +
LiveCD="LiveCD"
 +
LiveCD_Debug="LiveCD (Debug)"
 +
LiveCD_Screen="LiveCD (Screen)"
 +
BootCD="BootCD"
 +
BootCD_Debug="BootCD (Debug)"
 +
BootCD_Screen="BootCD (Screen)"
 +
 
 +
[LiveCD]
 +
BootType=Windows2003
 +
SystemPath=ramdisk(0)\reactos
 +
Options=/MININT /RDPATH=livecd.iso /RDEXPORTASCD
 +
 
 +
[LiveCD_Debug]
 +
BootType=Windows2003
 +
SystemPath=ramdisk(0)\reactos
 +
Options=/DEBUG /DEBUGPORT=COM1 /BAUDRATE=115200 /SOS /MININT /RDPATH=livecd.iso /RDEXPORTASCD
 +
 
 +
[LiveCD_Screen]
 +
BootType=Windows2003
 +
SystemPath=ramdisk(0)\reactos
 +
Options=/DEBUG /DEBUGPORT=SCREEN /SOS /MININT /RDPATH=livecd.iso /RDEXPORTASCD
 +
 
 +
[BootCD]
 +
BootType=ReactOSSetup
 +
SystemPath=ramdisk(0)\
 +
Options=/MININT /RDPATH=bootcd.iso /RDEXPORTASCD
 +
 
 +
[BootCD_Debug]
 +
BootType=ReactOSSetup
 +
SystemPath=ramdisk(0)\
 +
Options=/DEBUG /DEBUGPORT=COM1 /BAUDRATE=115200 /SOS /MININT /RDPATH=bootcd.iso /RDEXPORTASCD
  
Or watch this video-tutorial for different installation method: '''https://youtu.be/eancDwmWyCw'''  
+
[BootCD_Screen]
+
BootType=ReactOSSetup
Or try these unofficial experimental builds '''http://vgal.ru.com/reactos-0-4-10-new-usb/'''
+
SystemPath=ramdisk(0)\
 +
Options=/DEBUG /DEBUGPORT=SCREEN /SOS /MININT /RDPATH=bootcd.iso /RDEXPORTASCD
 +
</pre>
 +
'''Note:''' for detailed explanation, see [[Boot options]]
 +
* Now place <code>bootcd.iso</code> and/or <code>livecd.iso</code> in the root of the disk (or whatever path configured in <code>freeldr.ini</code>)
 +
* Ready to boot
  
=== USB RAM boot ===
+
=== Using virtual machine ===
 +
* Create a virtual machine but without the hard disk
 +
* Create a virtual hard disk for VirtualBox which points to the real one
 +
** on Linux: <code>VBoxManage internalcommands createrawvmdk -filename "~/VirtualBox VMs/reactos/disk.vmdk" -rawdisk PathToHarddisk</code>
 +
** important: <code>PathToHarddisk</code> must be the whole disk, not a partition: /dev/sdb
 +
* Add <code>disk.vmdk</code> to virtual machine via Storage => Add Harddisk
 +
* Install ReactOS as usual
  
RAM boot might prove useful when there is no other way to install ReactOS (mostly a case on modern notebooks that can boot only from the xHCI USB ports). Installation from RAM disk is possible since 0.4.11 release.
+
=== Network boot or installation via PXE ===
  
See [[User:Illen/RAM_Boot|RAM Boot]] article
+
See article [[Building PXE-ready ReactOS]].
  
=== Network boot or network installation via PXE ===
+
===Installing from internal drive===
See article [[Building PXE-ready ReactOS]]
+
See article [[User:Minecraftchest1/installing/installing-from-harddrive]]
  
== Installing drivers ==
+
= Installing drivers =
You may also be interested in how to install a driver for a device in ReactOS. If so, see [[Install a driver]] article.
+
You may be also interested to know how to install a driver for a device in ReactOS. If so, see [[Install a driver]] article.
  
== Unattended Installation ==
+
= Unattended Installation =
You may also be interested in how to install ReactOS in the automatic (non-interactive) mode. If so, see [[Create an unattended Installation CD]] article.
+
You may be also interested to know how to install ReactOS in the automatic (non-interactive) mode. If so, see [[Create an unattended Installation CD]] article.
  
== See also ==
+
= See also =
* [http://www.virtualbox.org/ VirtualBox] – a free virtualization software for Windows, Linux and Mac ([[VirtualBox|HOWTO]])
+
* [https://www.virtualbox.org/ VirtualBox] – a free virtualization software for Windows, Linux and Mac ([[VirtualBox|HOWTO]])
* [http://wiki.qemu.org/Main_Page QEMU] – an open source machine emulator
+
* [https://wiki.qemu.org/Main_Page QEMU] – an open source machine emulator
  
 
* [[Boot options]] for FreeLoader
 
* [[Boot options]] for FreeLoader

Latest revision as of 13:46, 30 September 2020

Icon speedy deletion.png Warning: Please bear in mind that ReactOS is still in alpha stage, meaning it is not stable or feature-complete and is not recommended for everyday use. Operating system bugs can and do result in corrupted file systems, overwritten partitions, and more. Do not install ReactOS on any computer containing important data without using a virtual machine or making full backups first.


Before installing

There are several things to be made aware of before installing ReactOS, or even obtaining the installation media. These include how ReactOS will be installed, limitations of the installation, and backing up existing data.

Limitations

ReactOS is alpha level (or alpha phase) software. It is not yet feature complete.
Some major bugs remain to be corrected. For the details see Known Issues. Bear in mind that this is not a complete list of known issues. See also Missing ReactOS Functionality.


The ReactOS itself, setup utility, and boot loader have a number of limitations. The most prominent are:

  • ReactOS is not able to boot from USB devices yet. Except RAM Boot method.
  • the setup utility does not prevent users from performing dangerous and potentially destructive operations.
  • UEFI system firmware is not supported by ReactOS yet, you have to use legacy BIOS mode.
  • some SATA controllers may not work with ReactOS.
  • the boot partition is highly recommended to be the first partition on the first (or even better - single) disk in the system.
  • the setup utility can check the integrity of ONLY FAT16 and FAT32 file systems.
  • HD Audio or use of multiple audio cards at the same time are not yet supported, ReactOS versions and builds prior to 0.4.12 will not boot after setup with this configuration.

System requirements

Hardware support

ReactOS has limited hardware support. Lists of particular hardware that have been tested can be found on the page Supported Hardware.

Minimum hardware requirements

The minimum requirements to install ReactOS are:

  • RAM: at least 64 MB, recommended 256 MB, and even 2048 MB if you want to test large software suites or bundles.
  • Processor: x86 or x64 architecture, Pentium or later and compatibles; for more information see ReactOS ports.
  • HDD: IDE/SATA with minimum 450 MB of free space on the primary partition (please note that some SATA controllers may not work with ReactOS):
    • FAT16/FAT32 primary boot partition.
  • Video: VGA compatible video card (VESA BIOS version 2.0 or later).

Getting ReactOS

Due to the current state of the project, the ReactOS Foundation does not offer official installation media for distribution. Installation CD-ROMs must be created by the user by writing an available image file to a CD-ROM.

Downloading the image file

Official ISO image files can be downloaded at one of the following locations:

WARNING: Some anti-malware programs will detect false positives in ReactOS files.

Creating the Installation CD

The downloaded file is a compressed archive in ZIP format, containing a single file named "ReactOS.iso". The ISO image contains everything needed to create the CD.

  • Extract the image file from the archive into a temporary directory.
  • Burn the ISO image to a CD-R or CD-RW using any software of your choice.

When burning the ISO to disc, be sure it is written as an image file. Writing to the disc as another type of data will not work and render the Installation CD unbootable. Look for an option similar to "Burn from ISO" or "Write disk image".

Installing ReactOS

Please consider making full backups of any sensitive data before you start any experiments with ReactOS in the production environment!

Installation strategy

The first consideration to make is whether to install ReactOS on a dedicated testing machine or in a contained environment, such as running on an emulator without direct disk access. The use of an emulator is preferable if the machine on which you will run ReactOS is your primary computer or if you have important data on the computer which you cannot afford to lose.

If you decide to install ReactOS on a disk drive that contains an existing operating system (such as Microsoft Windows XP), you should ensure that the drive is formatted with a file system ReactOS can access and write to (now, primary FAT32/FAT16 partition) and that there is sufficient free space on the drive such that ReactOS can be installed (now, >=450 MB). Furthermore, the current hardware limitations to which ReactOS is constrained must be identified and compared to the target computer system (e.g. that ReactOS has only basic audio support as of 0.4.12 release).

Once the available hardware and software situation is determined the installation media can be selected. In most cases, USB-RAM boot should be enough (or CD-ROM boot for virtual machines). But sometimes it may either not work or be not available for the particular system. Then you can use other available options as well.

ReactOS goes through three stages during setup. The first two stages deal with the installation of the system, while the third stage is the first usable boot by the user.

  • First stage – Text mode setup, started when booting from a ReactOS CD-ROM.
  • Second stage – Booting to GUI installer. The input of user information and registering of files.
  • Third stage – Booting to desktop, user configurations.

If you encounter problems, it is recommended to disable all secondary or unnecessary devices, especially USB-cameras and sound cards of any type.

Virtual Machines

A Virtual Machine is a software program that provides a virtual hardware platform. Software instructions that would be run on hardware are now interpreted by the emulator software. This allows you to "run" a different kind of computer hardware and its software in a window on your computer.

See article Virtualization software for the details.

Real hardware

Note For the real hardware experiments, we recommend you to use our "official" Dell Latitude D531 laptop or similar notebook models in order to achieve the best possible experience.

Ordinary CD-ROM method

  • Make sure your BIOS is configured to boot from the CD-ROM first.
  • If your PC has UEFI system firmware, then you have to enable legacy BIOS mode.
  • Insert the ReactOS setup CD-ROM into a CD-ROM drive and reboot your computer. On the next boot, the ReactOS setup utility will start.
  • Follow the instructions on the screen to install ReactOS on your computer.
  • After the installation has finished, remove the setup CD-ROM from the CD-ROM drive and press Enter to reboot your computer. You can now start ReactOS by selecting it from the boot menu.

USB Installation

Due to problems with the PnP manager, it is NOT currently possible to boot or install ReactOS from a USB stick made directly from *.iso file. You will get BSOD with 0x0000007B code. This worked previously but was broken several years ago by a rewrite of the USB code and major changes in the kernel. For USB boot you have to use RAM Boot method instead.

You can try applying a patch from PR #1569 and building from source, or try these unofficial experimental builds http://vgal.ru.com/reactos-0-4-10-new-usb/ (not recommended, they are very outdated).

USB-RAM boot

For this method, you should prepare a flash drive first. It should have a FAT32 filesystem and the Multiboot specification-capable bootloader should be installed on it. For example, you can use syslinux. Here is how to install it (for syslinux version 6.x):

On Linux

Plug in the flash drive and leave it unmounted. Then run these commands:

sudo mkfs.vfat /dev/sdb1
sudo syslinux --install /dev/sdb1

Note: here, /dev/sdb1 is a partition on a flash drive

On Windows

Use Rufus tool:

  • Select your flash drive
  • Click "Show advanced drive properties"
  • Boot selection: Syslinux 6.x
  • Partition scheme: MBR, File system: FAT32
  • Format the drive using selected options above

Next common steps for both platforms

At this point, you should have a bootloader installed onto the drive. Now it's time to copy some files onto it.

(Download all the required files, except iso images, in a zip-archive. It uses freeldr.sys from the fb4591c commit)

  • Now you need to copy mboot.c32 and libcom32.c32 syslinux libraries to the root
  • Then copy a freeldr.sys bootloader from ReactOS 0.4.13 or higher
  • Now you need to write some configuration files. First, syslinux.cfg:
DEFAULT ReactOS
LABEL ReactOS
  KERNEL mboot.c32
  APPEND /freeldr.sys
  • Then freeldr.ini:
[FREELOADER]
DefaultOS=BootCD_Debug
TimeOut=5

[Display]
TitleText=ReactOS LiveUSB
StatusBarColor=Cyan
StatusBarTextColor=Black
BackdropTextColor=White
BackdropColor=Blue
BackdropFillStyle=Medium
TitleBoxTextColor=White
TitleBoxColor=Red
MessageBoxTextColor=White
MessageBoxColor=Blue
MenuTextColor=Gray
MenuColor=Black
TextColor=Gray
SelectedTextColor=Black
SelectedColor=Gray
ShowTime=No
MenuBox=No
CenterMenu=No
MinimalUI=Yes
TimeText=Seconds until highlighted choice will be started automatically:

[Operating Systems]
LiveCD="LiveCD"
LiveCD_Debug="LiveCD (Debug)"
LiveCD_Screen="LiveCD (Screen)"
BootCD="BootCD"
BootCD_Debug="BootCD (Debug)"
BootCD_Screen="BootCD (Screen)"

[LiveCD]
BootType=Windows2003
SystemPath=ramdisk(0)\reactos
Options=/MININT /RDPATH=livecd.iso /RDEXPORTASCD

[LiveCD_Debug]
BootType=Windows2003
SystemPath=ramdisk(0)\reactos
Options=/DEBUG /DEBUGPORT=COM1 /BAUDRATE=115200 /SOS /MININT /RDPATH=livecd.iso /RDEXPORTASCD

[LiveCD_Screen]
BootType=Windows2003
SystemPath=ramdisk(0)\reactos
Options=/DEBUG /DEBUGPORT=SCREEN /SOS /MININT /RDPATH=livecd.iso /RDEXPORTASCD

[BootCD]
BootType=ReactOSSetup
SystemPath=ramdisk(0)\
Options=/MININT /RDPATH=bootcd.iso /RDEXPORTASCD

[BootCD_Debug]
BootType=ReactOSSetup
SystemPath=ramdisk(0)\
Options=/DEBUG /DEBUGPORT=COM1 /BAUDRATE=115200 /SOS /MININT /RDPATH=bootcd.iso /RDEXPORTASCD

[BootCD_Screen]
BootType=ReactOSSetup
SystemPath=ramdisk(0)\
Options=/DEBUG /DEBUGPORT=SCREEN /SOS /MININT /RDPATH=bootcd.iso /RDEXPORTASCD

Note: for detailed explanation, see Boot options

  • Now place bootcd.iso and/or livecd.iso in the root of the disk (or whatever path configured in freeldr.ini)
  • Ready to boot

Using virtual machine

  • Create a virtual machine but without the hard disk
  • Create a virtual hard disk for VirtualBox which points to the real one
    • on Linux: VBoxManage internalcommands createrawvmdk -filename "~/VirtualBox VMs/reactos/disk.vmdk" -rawdisk PathToHarddisk
    • important: PathToHarddisk must be the whole disk, not a partition: /dev/sdb
  • Add disk.vmdk to virtual machine via Storage => Add Harddisk
  • Install ReactOS as usual

Network boot or installation via PXE

See article Building PXE-ready ReactOS.

Installing from internal drive

See article User:Minecraftchest1/installing/installing-from-harddrive

Installing drivers

You may be also interested to know how to install a driver for a device in ReactOS. If so, see Install a driver article.

Unattended Installation

You may be also interested to know how to install ReactOS in the automatic (non-interactive) mode. If so, see Create an unattended Installation CD article.

See also

  • VirtualBox – a free virtualization software for Windows, Linux and Mac (HOWTO)
  • QEMU – an open source machine emulator