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)