Installation

Installing ReactOS is very much like installing Windows XP. However, due to it still undergoing heavy development, a few pointers are helpful when first getting started.

Installation Platform

ReactOS currently supports running on x86 processors with x64 support still in development. In additional to real hardware, ReactOS also supports running on a variety of virtual machine platforms. More details on setting up ReactOS can be found on the virtual machines page. Several caveats exist regarding what hardware ReactOS will work with and the following sections seek to document the more prominent issues.

Minimum System Requirement

  • Pentium I processor or later
  • 32 MB of RAM (Debug builds may require 48MB of RAM)
  • IDE/SATA hard disk drive with at least 350MB of space
  • VGA compatible video card (VESA BIOS version 2.0 or later)
  • PS/2 keyboard
  • PS/2 compatible mouse or Microsoft Mouse compatible serial mouse

Drives

  • ReactOS has uneven support for SATA drives. It is recommended that IDE compatibility mode be used for best results
  • The boot partition must be the first FAT16 or FAT32 partition on the disk.
  • The setup utility cannot check the integrity of file systems.

USB

USB support is still in development and not all devices are yet supported. Generally it is advised to set USB keyboard and mice to legacy mode in the BIOS when installing ReactOS.

Boot Options

A variety of options can be added to the freeldr.ini file to change the configuration that ReactOS will boot into. The following is an example of an entry for booting ReactOS in a specific configuration.

[ReactOS]
BootType=ReactOS
SystemPath=multi(0)disk(0)rdisk(0)partition(1)\reactos
Options=/DEBUGPORT=SCREEN

DEBUG

Turn on debugging output. This option is automatically turned on when running a debug build of ReactOS.

To specify output device use DEBUGPORT option. If DEBUGPORT is not specified output by default goes to COM1.

Format: DEBUG

DEBUGPORT

Specifying DEBUGPORT as a boot option will enable certain debugging features.

Format: DEBUGPORT=[SCREEN|BOCHS|GDB|PICE|COM1|COM2|COM3|COM4|COM:|FILE|MDA]
Any one of the following values may set:

  • SCREEN: Send debug output to the screen.
  • BOCHS: Send debug output to bochs.
  • GDB: Enable the GNU debugger (GDB) stub so remote debugging using GDB is possible.
  • PICE: Enable the Private ICE driver so debugging using Private ICE is possible.
  • COM#: Send debug output to COM port #.
  • COM:[hex address]: Specifies the COM port address. (Example: /DEBUGPORT=COM:0xCC00 )
  • FILE: Send debug output to a file %systemroot%/reactos/debug.log
  • MDA: Send debug output to MDA (The old text graphics card from IBM).

It is permitted to use several DEBUGPORT options, but for ports of the same class, for example, COM ports, only the last one will be used for output.

BAUDRATE

Specifies baudrate of the serial port to be [baudrate] bps. Used in conjunction with COM1-4 or GDB.

Format: BAUDRATE=[baudrate]

IRQ

Specifies the IRQ number of the serial port to be [irq-number]. Used in conjunction with COM1-4 or GDB.

Format: IRQ=[irq-number]

PROFILE

Enables profiling. Profiling information will be written in %windir%\profiler.log. This will slow down the system quite a bit.

Format: PROFILE

MAXMEM

Will restrict ReactOS to use only the first [maxmem] MB of physical memory.

Format: MAXMEM=[maxmem]

NOGUIBOOT

Disables the bitmap that displays the progress bar at ReactOS startup.

Format: NOGUIBOOT

FIRSTCHANCE

Set up exceptions to be passed to debugger on its occurrence, before being handled by regular exception handling code.

Format: FIRSTCHANCE

MININT

Loads the Registry SYSTEM hive as a volatile hive, such, that changes made to it in memory are not saved back to the hive image, into registry file. Useful for running ReactOS from a liveCD.

Format: MININT