summaryrefslogtreecommitdiff
path: root/doc/sphinx/frags/using-anastasis-config.rst
blob: 2c0a1ca08ef3e84fdbb88611355cec9c502d88d8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
Using anastasis-config
----------------------

The tool ``anastasis-config`` can be used to extract or manipulate
configuration values; however, the configuration use the well-known INI
file format and can also be edited by hand.

Run

.. code-block:: console

   $ anastasis-config -s $SECTION

to list all of the configuration values in section ``$SECTION``.

Run

.. code-block:: console

   $ anastasis-config -s $section -o $option

to extract the respective configuration value for option ``$option`` in
section ``$section``.

Finally, to change a setting, run

.. code-block:: console

   $ anastasis-config -s $section -o $option -V $value

to set the respective configuration value to ``$value``. Note that you
have to manually restart the Taler backend after you change the
configuration to make the new configuration go into effect.

Some default options will use $-variables, such as ``$DATADIR`` within
their value. To expand the ``$DATADIR`` or other $-variables in the
configuration, pass the ``-f`` option to ``anastasis-config``. For example,
compare:

.. code-block:: console

   $ anastasis-config -s ACCOUNT-bank \
                  -o WIRE_RESPONSE
   $ anastasis-config -f -s ACCOUNT-bank \
                  -o WIRE_RESPONSE

While the configuration file is typically located at
``$HOME/.config/taler.conf``, an alternative location can be specified
to ``taler-merchant-httpd`` and ``anastasis-config`` using the ``-c``
option.