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