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