NAME

       radiusd.conf - configuration file for the FreeRADIUS server

DESCRIPTION

       The  radiusd.conf  file  resides in the radius database directory, by default /etc/raddb.  It defines the
       global configuration for the FreeRADIUS RADIUS server.

CONTENTS

       There are a large number of configuration parameters for the server.  Most are  documented  in  the  file
       itself  as comments.  This page documents only the format of the file.  Please read the radiusd.conf file
       itself for more information.

       The configuration file parser is independent of the server configuration.  This means that  you  can  put
       almost anything into the configuration file.  So long as it is properly formatted, the server will start.

       When  the  server  parses  the configuration file, it looks only for those configurations it understands.
       Extra configuration items are ignored.  This "feature" can be (ab)used in certain interesting ways.

FILE FORMAT

       The file format is line-based, like many other Unix configuration files.  Each entry in the file must  be
       placed on a line by itself, although continuations are supported.

       The file consists of configuration items (variable = value pairs), sections, and comments.

       Variables
              Variables can be set via:

                   name = value

              Single and double-quoted strings are permitted:

                   string1 = "hello world"
                   string2 = 'hello mom'

       Sections
              A  section  begins with a section name, followed on the same line by an open bracket '{'.  Section
              may contain other sections, comments, or variables.  Sections may be nested to any depth,  limited
              only by available memory.  A section ends with a close bracket ´}', on a line by itself.

                   section {
                        ...
                   }

              Sections  can  sometimes have a second name following the first one.  The situations where this is
              legal depend on the context.  See the examples and comments in  the  radiusd.conf  file  for  more
              information.

                   section foo {
                        ...
                   }

       Comments
              Any  line  beginning  with  a  (#) is deemed to be a comment, and is ignored.  Comments can appear
              after a variable or section definitions.

                   # comment
                   foo = bar # set variable 'foo' to value 'bar'
                   section { # start of section
                   ...
                   }         # end of section

       Continuations
              Long lines can be broken up via continuations, using '\' as the last character of the  line.   For
              example, the following entry:

                   foo = "blah \
                   blah \
                   blah"

              will  set  the value of the variable "foo" to "blah blah blah".  Any CR or LF is not turned into a
              space, but all other whitespace is preserved in the final value.

REFERENCES

       The value of a variable can  reference  another  variable.   These  references  are  evaluated  when  the
       configuration  file  is  loaded,  which  means that there is no run-time cost associated with them.  This
       feature is most useful for turning long, repeated pieces of text into short ones.

       Variables are referenced by ${variable_name}, as in the following examples.

            foo = bar       # set variable 'foo' to value 'bar'
            who = ${foo}    # sets variable 'who' to value of variable 'foo'
            my = "${foo} a" # sets variable 'my' to "bar a"

       If   the   variable   exists   in   a   section   or   subsection,    it    can    be    referenced    as
       ${section.subsection.variable}.  Forward references are not allowed.  Relative references are allowed, by
       pre-pending the name with one or more period.

            blogs = ${.foo}

       Will set variable blogs to the value of variable foo, from the current section.

            blogs = ${..foo}

       Will  set  variable  blogs  to  the  value  of  variable foo, from the section which contains the current
       section.

            blogs = ${modules.detail.detailfile}

       Will set variable blogs to the value of variable detailfile, of  the  detail  module,  which  is  in  the
       modules section of the configuration file.

FILES

       /etc/raddb/radiusd.conf

SEE ALSO

       radiusd(8) unlang(5)

AUTHOR

       Alan DeKok <aland@freeradius.org>

                                                   12 Jun 2007                                   radiusd.conf(5)