Added more simple text to help people get the server up and running.
[freeradius.git] / INSTALL
1   Please read the README in the doc/ subdirectory. Section 2 gives you
2 complete details on how to configure, compile and install FreeRADIUS.
3
4   If you do not need to modify the default configuration, then take
5 the following steps to build and install the server:
6
7
8         $ ./configure
9         $ make
10         $ make install
11
12   Then, start the server in debugging mode:
13
14         $ radiusd -X
15
16   You should see a lot of text printed on the screen as it starts up.
17 If you don't, or if you see error messages, please read the FAQ:
18
19         http://www.freeradius.org/faq/
20
21   If the server says "Ready to process requests.", then it is running
22 properly.  From another shell (or another window), type:
23
24         $ radtest test test localhost 0 testing123
25
26   You should see the server print out more messages as it receives the
27 request, and responds to it.  The 'radtest' program should receive the
28 response within a few seconds.  It doesn't matter if the
29 authentication request is accepted or rejected, what matters is that
30 the server received the request, and responded to it.
31
32   You can now edit the 'radiusd.conf' file for your local system.
33 Please read the ENTIRE file carefully, as many configuration options
34 are only documented in comments in the file.
35
36   Configuring and running the server MAY be complicated.  Please read
37 the documentation in the doc/ directory for further information.  If
38 you have any issues, the FAQ is also a good place to check.