NAME

       radiusd.conf - configuration file for the FreeRADIUS server

DESCRIPTION

       The   radiusd.conf   file   resides   in   the   radius  database  directory,  by  default
       /etc/freeradius/3.0.  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.filename}

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

       Properties  of  anonymous  parent  sections  may  also  be  referenced, currently name and
       instance are supported.

            modules {           example foo {                file = ${.:name}           }       }
             Will set variable file to the name of the containing section (example).

            modules  {            example  foo  {                file = ${.:instance}           }
            }       Will set variable file to the instance name of the containing section (foo).

            modules {           example foo {                file = ${..:name}           }      }
              Will  set  variable  file  to  the  name  of  the  parent of the containing section
       (modules).

FILES

       /etc/freeradius/3.0/radiusd.conf

SEE ALSO

       radiusd(8) unlang(5)

AUTHOR

       Alan DeKok <aland@freeradius.org>

                                           28 Jun 2013                            radiusd.conf(5)