From b2c2647934f96727cc9adaae9b59374161b5c662 Mon Sep 17 00:00:00 2001 From: ms Date: Wed, 4 May 2022 15:37:46 +0200 Subject: Sandbox tutorial. Section about the default demobank. --- libeufin/nexus-tutorial.rst | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) (limited to 'libeufin/nexus-tutorial.rst') 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 -- cgit v1.2.3