summaryrefslogtreecommitdiff
path: root/frags/using-taler-config.rst
diff options
context:
space:
mode:
authorThien-Thi Nguyen <ttn@gnuvola.org>2020-12-11 00:52:20 -0500
committerThien-Thi Nguyen <ttn@gnuvola.org>2020-12-11 00:52:20 -0500
commit207adf498816ab5b033b8c1f51c94aeeb6a6d344 (patch)
treec994bb332737ab2ea16a5c6f5abc27fcbb699e5c /frags/using-taler-config.rst
parentf72a46f462f9070fa4a48b240c309f7554e735f6 (diff)
downloaddocs-207adf498816ab5b033b8c1f51c94aeeb6a6d344.tar.gz
docs-207adf498816ab5b033b8c1f51c94aeeb6a6d344.tar.bz2
docs-207adf498816ab5b033b8c1f51c94aeeb6a6d344.zip
add frag: using-taler-config.rst
Diffstat (limited to 'frags/using-taler-config.rst')
-rw-r--r--frags/using-taler-config.rst53
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 0000000..d7c28b2
--- /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.
+