Configuration
=============

**Rsyslogd is configured via the rsyslog.conf file**, typically found in
``/etc``. By default, rsyslogd reads the file ``/etc/rsyslog.conf``.
This can be changed by a command line option.

Note that **configurations can be built interactively** via the online
`rsyslog configuration builder <http://www.rsyslog.com/rsyslog-configuration-builder/>`_ tool.

.. toctree::
   :maxdepth: 2

   conf_formats
   converting_to_new_format
   sysklogd_format
   basic_structure
   templates
   properties
   property_replacer
   filters
   ../rainerscript/index
   actions
   input
   parser
   timezone
   examples
   index_directives
   rsyslog_statistic_counter
   modules/index
   output_channels
   droppriv
   ipv6
   cryprov_gcry
   dyn_stats
   lookup_tables

`Configuration file examples can be found in the rsyslog
wiki <http://wiki.rsyslog.com/index.php/Configuration_Samples>`_. Also
keep the `rsyslog config
snippets <http://www.rsyslog.com/config-snippets/>`_ on your mind. These
are ready-to-use real building blocks for rsyslog configuration.

There is also one sample file provided together with the documentation
set. If you do not like to read, be sure to have at least a quick look
at :download:`rsyslog-example.conf <rsyslog-example.conf>`.

While rsyslogd contains enhancements over standard syslogd, efforts have
been made to keep the configuration file as compatible as possible.
While, for obvious reasons, :doc:`enhanced features <../features>` require
a different config file syntax, rsyslogd should be able to work with a
standard syslog.conf file. This is especially useful while you are
migrating from syslogd to rsyslogd.
