diff options
| -rw-r--r-- | frags/using-taler-config.rst | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/frags/using-taler-config.rst b/frags/using-taler-config.rst new file mode 100644 index 00000000..d7c28b23 --- /dev/null +++ b/frags/using-taler-config.rst @@ -0,0 +1,53 @@ +.. _Using-taler_002dconfig-exchange: + +Using taler-config +------------------ + +The tool ``taler-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 + + $ taler-config -s $SECTION + +to list all of the configuration values in section ``$SECTION``. + +Run + +.. code-block:: console + + $ taler-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 + + $ taler-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 ``taler-config``. For example, +compare: + +.. code-block:: console + + $ taler-config -s ACCOUNT-bank \ + -o WIRE_RESPONSE + $ taler-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 ``taler-config`` using the ``-c`` +option. + |