81997a676dc739924f609749032c2a3ebe3b6d9a
[reactos.git] / reactos / INSTALL
1 1. Build environment
2
3 To build the system you need either mingw32 installed on Windows or a mingw32
4 cross compiler running on unix.
5
6
7 2. Building ReactOS
8
9 To build from Windows run 'make' (wihout the quotes) from the top directory.
10 To build from unix, edit rules.mak and change the PREFIX variable to the
11 correct value for your cross-compiler, then run 'make'.
12
13
14 3. Installation
15
16 The system can only be installed on the first partition on the first harddisk.
17 The partition must be formatted as FAT16 or FAT32. The system can only be
18 started from DOS and not from a Windows DOS-prompt.
19
20 ReactOS can be installed from the source distribution or from the binary
21 distribution. The two ways to install ReactOS are explained below.
22
23
24 3.1 Installation from sources
25
26 To install ReactOS after building it, type 'make install'. This will create
27 the directory 'reactos' in the top directory. Copy this directory to the root
28 of your first partition on your first harddisk. This is usually c:\ on a
29 Windows machine.
30
31 If you don't want to copy the files manually every time you run a 'make install',
32 you can specify the directory where the files are to be copied to during
33 installation.
34
35 In rules.mak find the variable INSTALL_DIR and change the assigned value to the
36 name of the directory where the files are to be copied to. If you are using
37 Windows this could be:
38
39 INSTALL_DIR = c:\reactos
40
41 If you are on linux this could be:
42
43 INSTALL_DIR = /mnt/windows/reactos
44
45 Save the changes to rules.mak and run 'make install' to install the files to
46 the new location.
47
48
49 3.2 Installation from binany distribution
50
51 To install ReactOS from the binary distribution, extract the archive contents
52 to c:\reactos. Remember to extract the files with full paths.
53
54
55 4. Booting ReactOS
56
57 Startup in DOS mode. 'cd' to c:\reactos and type 'boot' and press <enter>.
58 ReactOS will now boot and when it has booted, you are asked for a username and
59 password. Just press <enter> twice as ReactOS does not currently have user
60 validation. A simple shell is started where you can use simple commands like
61 'cd' and 'dir'.
62
63 You may also want to try running the enhanced shell, cmd.exe, found in
64 the rosapps CVS module.
65
66
67 5. Help
68
69 If you run into problems or have suggestions for making ReactOS better, please
70 surf to the address below and subscribe to one or more of the mailing lists.
71
72 http://www.reactos.com/index.php?tab=discussion&section=lists
73
74 ReactOS Development Team