taler.conf(5)
#############
.. only:: html
Name
====
**taler.conf** - Taler configuration file
Description
===========
.. include:: ../frags/common-conf-syntax.rst
Files containing default values for many of the options described below
are installed under ``$TALER_PREFIX/share/libeufin-nexus/config.d/``.
The configuration file given with **-c** to Taler 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 ``taler-config -V VALUE`` to change configuration
values: it will destroy all uses of ``@INLINE@`` and furthermore remove all
comments from the configuration file!
GLOBAL OPTIONS
--------------
Setting the database belongs to the “[nexus-postgres]” section and the
following value.
CONFIG
PostgreSQL connection string. Note: this option is NOT used by the
ebics-setup subcommand, as it stores the key files directly on the
filesystem.
The “[paths]” section is special in that it contains paths that can be
referenced using “$” in other configuration values that specify
filenames. For Taler, it commonly contains the following paths:
LIBEUFIN_HOME
Home directory of the user, usually “${HOME}”. Can be overwritten by
testcases by setting ${LIBEUFIN_TEST_HOME}.
EBICS SETUP OPTIONS
-------------------
The following options are from the “[nexus-ebics]” section and used by
the ``libeufin-nexus ebics-setup`` command.
CURRENCY
Name of the currency, e.g. “EUR” for Euro.
HOST_BASE_URL = http://bank.example.com/
URL of the EBICS server
BANK_DIALECT
Name of the following combination: EBICS version and ISO20022 recommendations
that Nexus would honor in the communication with the bank. Currently only the
'postfinance' value is supported.
HOST_ID
EBICS specific: name of the EBICS host
USER_ID
EBICS specific: user ID of the EBICS subscriber. This value must be assigned
by the bank after having activated a new EBICS subscriber.
PARTNER_ID
EBICS specific: partner ID of the EBICS subscriber. This value must be assigned
by the bank after having activated a new EBICS subscriber.
BANK_PUBLIC_KEYS_FILE
Filesystem location where Nexus should store the bank public keys.
CLIENT_PRIVATE_KEYS_FILE
Filesystem location where Nexus should store the subscriber private keys.
IBAN
IBAN of the bank account that is associated with the EBICS subscriber.
BIC
BIC of the bank account that is associated with the EBICS subscriber.
NAME
Legal entity that is associated with the EBICS subscriber.
EBICS SUBMIT OPTIONS
--------------------
The following configuration value(s) belong to the “[nexus-submit]” section.
FREQUENCY
Duration value to instruct the ``ebics-submit`` subcommand how much to wait
before checking the database again to find new unsubmitted payments. The duration
must be expressed with a number followed by the time unit. The following time
units are supported: 's' (seconds), 'm' (minutes), 'h' (hours). For example,
the value *5m* causes retries to be run every five minutes.
SUBMISSIONS_LOG_DIRECTORY
Optional value to define the path where the pain.001 documents would be stored
after a submission. This directory would contain several directories, each named
after the YYYY-MM-DD format. The pain.001 file would then be named in the following
schema: ``$submissionTimestampMicroseconds_requestUid_$requestUid_pain.001.xml``.
``$requestUid`` is the same value that constitutes the pain.001 ``MsgIg`` element.
In the event that one log file would be overridden, ``ebics-submit`` fails without
overriding it.
EBICS FETCH OPTIONS
-------------------
The following configuration value(s) belong to the “[nexus-fetch]” section.
FREQUENCY
Duration value to instruct the ``ebics-fetch`` subcommand how often it should
download from the bank. The duration must be expressed with a number followed
by the time unit. The following time units are supported: 's' (seconds), 'm'
(minutes), 'h' (hours). For example, the value *5m* causes downloads to be run
every five minutes.
STATEMENT_LOG_DIRECTORY
Optional value to define the path where the downloaded documents would be stored
This directory would contain several directories, each named after the YYYY-MM-DD
format. The stored files would then be named in the following schema:
``$downloadTimestampMicroseconds_$filenameAsGivenByTheBank``. In the event that
one log file would be overridden, ``ebics-fetch`` fails without overriding it.
Exception to this naming scheme are the HAC responses, since they do not get any
filename assigned by the ZIP archive (they are sent unzipped). Their naming scheme
is: ``$downloadTimestampMicroseconds_HAC_response.pain.002.xml``
SEE ALSO
========
libeufin-nexus(1)
BUGS
====
Report bugs by using https://bugs.taler.net/ or by sending electronic
mail to .