taler-docs

commit b2c2647934f96727cc9adaae9b59374161b5c662
parent 5c6407710188c0b24086f63e1af672fdc7d1d285
Author: ms <ms@taler.net>
Date:   Wed,  4 May 2022 15:37:46 +0200

Sandbox tutorial.

Section about the default demobank.

Diffstat:
M
libeufin/nexus-tutorial.rst
 | 
20
++++++++++++++++++--

1 file changed, 18 insertions(+), 2 deletions(-)
diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst
@@ -153,8 +153,24 @@ If this variable is not set, ``libeufin-sandbox`` complains and exits:
 
 Only *SQLite* and *PostgreSQL (via TCP)* are supported right now.
 
-For the following commands, the sandbox service must be running.
-The sandbox service is started with the following command:
+Before being usable, a Sandbox needs to be configured.  This is done
+by creating the `default` demobank.  A demobank is a set of configuration
+values associated to one name; in the example below, we'll create one
+named `default`, that is mandatory to have.
+
+.. note::
+
+   By design, many demobanks can be hosted by one running Sandbox,
+   although at the time of writing only the 'default' one is supported.
+
+A default demobank having the EUR currency is created with the following command:
+
+.. code-block:: console
+
+   $ export LIBEUFIN_SANDBOX_DB_CONNECTION=jdbc:sqlite:/tmp/libeufintestdb
+   $ libeufin-sandbox config --currency EUR default
+
+The sandbox service can now be started with the following command:
 
 .. code-block:: console