challenger.conf - Challenger configuration file
The configuration file is line-oriented.
Blank lines and whitespace at the beginning and end of a line are ignored.
Comments start with
% in the first column
(after any beginning-of-line whitespace) and go to the end of the line.
The file is split into sections.
Every section begins with “[SECTIONNAME]” and
contains a number of options of the form “OPTION=VALUE”.
There may be whitespace around the
= (equal sign).
Section names and options are case-insensitive.
The values, however, are case-sensitive.
In particular, boolean values are one of
Values can include whitespace by surrounding
the entire value with
" (double quote).
Note, however, that there are no escape characters in such strings;
all characters between the double quotes (including other double quotes)
are taken verbatim.
Values that represent filenames can begin with a
This can be simple, such as
$TMPDIR/foo, or complex,
Values that represent a time duration are represented as a series
of one or more
NUMBER UNIT pairs, e.g.
4 weeks 1 day,
5 years 2 minutes.
Values that represent an amount are in the usual amount syntax:
FRACTION portion may extend up to 8 places.
The “[PATHS]” section is special in that it contains paths that can be
referenced using “$” in other configuration values that specify
filenames. Note that configuration options that are not specifically
retrieved by the application as filenames will not see “$”-expressions
expanded. To expand “$”-expressions when using
taler-config, you must pass
-f command-line option.
The system automatically pre-populates the “[PATHS]” section with a few values
at run-time in addition to the values that are in the actual configuration
file. These automatically generated values refer to installation properties
from GNU autoconf. The
values are usually dependent on an
INSTALL_PREFIX which is determined by
--prefix option given to configure. The canonical values are:
- LIBEXECDIR = $INSTALL_PREFIX/taler/libexec/
- DOCDIR = $INSTALL_PREFIX/share/doc/taler/
- ICONDIR = $INSTALL_PREFIX/share/icons/
- LOCALEDIR = $INSTALL_PREFIX/share/locale/
- PREFIX = $INSTALL_PREFIX/
- BINDIR = $INSTALL_PREFIX/bin/
- LIBDIR = $INSTALL_PREFIX/lib/taler/
- DATADIR = $INSTALL_PREFIX/share/taler/
Note that on some platforms, the given paths may differ depending on how the system was compiled or installed, the above are just the canonical locations of the various resources.
Files containing default values for many of the options described below
are installed under
The configuration file given with -c to Challenger binaries
overrides these defaults.
A configuration file may include another, by using the
for example, in
main.conf, you could write
@INLINE@ sub.conf to
include the entirety of
sub.conf at that point in
Be extra careful when using
challenger-config -V VALUE to change configuration
values: it will destroy all uses of
@INLINE@ and furthermore remove all
comments from the configuration file!
The following options are from the “[challenger]” section. This is normally the only section in a challenger.conf file.
::1for loopback. Can also be given as a hostname. We will bind to the wildcard (dual-stack) if left empty. Only used if
UNIXPATH? Only used if
/token). After this time, the garbage collection process can delete all associated data. (Note that tokens will always allow access to 1h after they have been issued, regardless of when the validation expires).
/infoendpoint. Examples include
challenger-dbinit(1), challenger-httpd(1), challenger-config(1).
Report bugs by using https://bugs.taler.net/ or by sending electronic mail to <email@example.com>.