commit 34f3b4f0fcf1729f258d7a20c51c315111930a74
parent 747637dac068daf7a02efcf69f3c0eb90285ee89
Author: Antoine A <>
Date: Sun, 28 Dec 2025 21:28:44 +0100
cyclos: improve manual and update conf
Diffstat:
2 files changed, 33 insertions(+), 3 deletions(-)
diff --git a/manpages/taler-cyclos.conf.5.rst b/manpages/taler-cyclos.conf.5.rst
@@ -55,6 +55,12 @@ PASSWORD
ACCOUNT_TYPE
Specify the account type and therefore the indexing behavior. This can either can be ``normal`` or ``exchange``. Exchange accounts bounce invalid incoming Taler transactions.
+ACCOUNT_TYPE_ID
+ Cyclos account type ID to index
+
+PAYMENT_TYPE_ID
+ Cyclos payment type ID to use for transfers
+
HTTP SERVER OPTIONS
-------------------
diff --git a/taler-cyclos-manual.rst b/taler-cyclos-manual.rst
@@ -183,8 +183,6 @@ Update the configuration files:
[cyclos]
CURRENCY = KUDOS
- ACCOUNT_ID = 7762070814178012479
- NAME = John Smith S.A.
.. code-block:: ini
:caption: /etc/taler-cyclos/secrets/cyclos-worker.secret.conf
@@ -194,12 +192,38 @@ Update the configuration files:
USERNAME = admin
PASSWORD = password
-And finaly run the setup process:
+And then run the setup process:
.. code-block:: console
$ sudo -u taler-cyclos-worker taler-cyclos -c /etc/taler-cyclos/taler-cyclos.conf setup
+If the previous command failed with a ``inaccessibleChannel`` you will have to enable the ``Web services`` channel in you account settings. If this channel is disabled, you should contact the network administrators.
+
+The setup process should fail and provide you with the information needed to fill in the required Cyclos IDs:
+
+.. code-block:: ini
+ :caption: /etc/taler-cyclos/taler-cyclos.conf
+
+ [cyclos]
+ ACCOUNT_ID = 7762070814178012479
+ NAME = John Smith S.A.
+
+.. code-block:: ini
+ :caption: /etc/taler-cyclos/conf.d/cyclos-worker.conf
+
+ [cyclos-worker]
+ ACCOUNT_TYPE_ID = 7762070814178012479
+ PAYMENT_TYPE_ID = 7762070814178012479
+
+And finaly run the setup process again:
+
+.. code-block:: console
+
+ $ sudo -u taler-cyclos-worker taler-cyclos -c /etc/taler-cyclos/taler-cyclos.conf setup
+
+This time, you should not see any errors; if you do, you should modify the configuration until it works.
+
Wire Gateway setup
------------------
