17.5. sync.conf(5)

17.5.1. Name

sync.conf - Sync configuration file

17.5.2. Description

The configuration file is line-oriented. Blank lines and whitespace at the beginning and end of a line are ignored. Comments start with # or % 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 YES or NO. 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 /bin/sh-like variable reference. This can be simple, such as $TMPDIR/foo, or complex, such as ${TMPDIR:-${TMP:-/tmp}}/foo. See [PATHS] (below).

Values that represent a time duration are represented as a series of one or more NUMBER UNIT pairs, e.g. 60 s, 4 weeks 1 day, 5 years 2 minutes.

Values that represent an amount are in the usual amount syntax: CURRENCY:VALUE.FRACTION, e.g. EUR:1.50. The FRACTION portion may extend up to 8 places.

Files containing default values for many of the options described below are installed under $PREFIX/share/sync/config.d/. The configuration file given with -c to Sync binaries overrides these defaults.

A configuration file may include another, by using the @INLINE@ directive, for example, in main.conf, you could write @INLINE@ sub.conf to include the entirety of sub.conf at that point in main.conf.

Be extra careful when using sync-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 “[sync]” section. This is normally the only section in a sync.conf file.

This can either be tcp or unix.
Port on which the HTTP server listens, e.g. 9967. Only used if SERVE is tcp.
Which IP address should we bind to? E.g. or ::1 for loopback. Can also be given as a hostname. We will bind to the wildcard (dual-stack) if left empty. Only used if SERVE is tcp.
Which unix domain path should we bind to? Only used if SERVE is unix.
What should be the file access permissions for UNIXPATH? Only used if SERVE is unix.
Plugin to use for the database, e.g. “postgres”.
Annual fee for an account. This is in the usual amount syntax, e.g. TESTKUDOS:0.1.
Insurance provided against loss, e.g. TESTKUDOS:0.0.
Upload limit per backup, in megabytes, e.g. 16.
Fulfillment URL of the SYNC service itself.
Base URL of our payment backend.
API key to pass when accessing the merchant backend. This is a secret value.

17.5.3. SEE ALSO

sync-dbinit(1), sync-httpd(1), sync-config(1).

17.5.4. BUGS

Report bugs by using https://bugs.taler.net/ or by sending electronic mail to <taler@gnu.org>.