summaryrefslogtreecommitdiff
path: root/libeufin/nexus-tutorial.rst
diff options
context:
space:
mode:
authorms <ms@taler.net>2022-05-04 15:37:46 +0200
committerms <ms@taler.net>2022-05-04 15:38:11 +0200
commitb2c2647934f96727cc9adaae9b59374161b5c662 (patch)
tree6da75ad6138111c3c6e6a7c7147f59eebf43b76f /libeufin/nexus-tutorial.rst
parent5c6407710188c0b24086f63e1af672fdc7d1d285 (diff)
downloaddocs-b2c2647934f96727cc9adaae9b59374161b5c662.tar.gz
docs-b2c2647934f96727cc9adaae9b59374161b5c662.tar.bz2
docs-b2c2647934f96727cc9adaae9b59374161b5c662.zip
Sandbox tutorial.
Section about the default demobank.
Diffstat (limited to 'libeufin/nexus-tutorial.rst')
-rw-r--r--libeufin/nexus-tutorial.rst20
1 files changed, 18 insertions, 2 deletions
diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst
index df8ba1b3..9eca0eb0 100644
--- 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