euFin tutorial

how to specify default exchange and hook Nginx to the Sandbox.

1 files changed, 21 insertions, 0 deletions

diff --git a/libeufin/nexus-tutorial.rst b/libeufin/nexus-tutorial.rst
index d0aed0e8..e8a40064 100644
--- a/libeufin/nexus-tutorial.rst
+++ b/libeufin/nexus-tutorial.rst
@@ -170,6 +170,13 @@ A default demobank having the EUR currency is created with the following command
    $ export LIBEUFIN_SANDBOX_DB_CONNECTION=jdbc:sqlite:/tmp/libeufintestdb
    $ libeufin-sandbox config --currency EUR default
 
+In order to use Taler, a default exchange needs to be configured.
+
+.. code-block:: console
+
+   $ export LIBEUFIN_SANDBOX_DB_CONNECTION=jdbc:sqlite:/tmp/libeufintestdb
+   $ libeufin-sandbox default-exchange --demobank default $exchange_base_url $exchange_payto_address
+
 The sandbox service can now be started with the following command:
 
 .. code-block:: console
@@ -178,6 +185,20 @@ The sandbox service can now be started with the following command:
    $ export LIBEUFIN_SANDBOX_DB_CONNECTION=jdbc:sqlite:/tmp/libeufintestdb
    $ libeufin-sandbox serve --port 5016
 
+The instructions below hook Nginx to the Sandbox:
+
+.. code-block:: console
+
+  redirect / to /demobanks/default;
+  rewrite ^/$ https://$host/demobanks/default; 
+  location / {
+    proxy_set_header Host $host;
+    proxy_set_header X-Forwarded-Host $host;
+    proxy_set_header X-Forwarded-Proto "https";
+    proxy_set_header X-Forwarded-Prefix "/";
+    proxy_pass http://localhost:5016/; 
+  }
+
 To reset the state of the sandbox, delete the database.
 
 For invocations of the LibEuFin command-line interface tool (``libeufin-cli``),