[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[taler-docs] branch master updated: NLnet docs (Docker setup).

From: gnunet
Subject: [taler-docs] branch master updated: NLnet docs (Docker setup).
Date: Mon, 06 Mar 2023 13:41:11 +0100

This is an automated email from the git hooks/post-receive script.

ms pushed a commit to branch master
in repository docs.

The following commit(s) were added to refs/heads/master by this push:
     new 36eb461  NLnet docs (Docker setup).
36eb461 is described below

commit 36eb461591c2745f1514286f2a6fd7895801b5d1
Author: MS <>
AuthorDate: Mon Mar 6 13:40:31 2023 +0100

    NLnet docs (Docker setup).
 libeufin/local-currencies-tutorial.rst | 57 ++++++++++++++++++++++++----------
 1 file changed, 41 insertions(+), 16 deletions(-)

diff --git a/libeufin/local-currencies-tutorial.rst 
index 510c14e..2178eca 100644
--- a/libeufin/local-currencies-tutorial.rst
+++ b/libeufin/local-currencies-tutorial.rst
@@ -50,7 +50,7 @@ password as ``secret``.
 .. code-block:: console
-   $ libeufin-sandbox serve
+   $ libeufin-sandbox serve --port 5016
 If Sandbox is running, jump to `this part <after-installation_>`_.
@@ -79,28 +79,53 @@ Now build the image with the following command.
   $ docker build -t nlnet .
 If the build step went well, the following command
-should suffice to start Sandbox and bind it to the
-host's port 5000. 
+should suffice to start Sandbox and NGINX, by mapping
+the host's 8080 port to the container's 80.
 .. code-block:: console
+  $ export LIBEUFIN_EXPOSED_PORT=8080
+  $ docker run \
+    -it nlnet
-  $ docker run -p 5000:5000 -v libeufin_data:/libeufin-data -it nlnet
+The previous command uses a default admin password of 'admin'.
+Do **CHANGE** the admin password in a production scenario.  The
+following command shows how to start the services with custom
-The previous command uses a default admin password of
-'admin' and the NB currency.  Do **CHANGE** the admin
-password in a production scenario.  The following command
-shows how to start the Sandbox with custom administrator
-password and currency (defaults to EUR otherwise).
+.. note::
+   Start the services this way to provide the environment
+   suitable for this tutorial.
 .. code-block:: console
-   $ export MY_PASSWORD=secret
-v libeufin_data:/libeufin-data -p 5000:5000 -it nlnet
+   $ export MY_ADMIN_PASSWORD=secret
+   $ export LIBEUFIN_EXPOSED_PORT=8080
+   $ docker run \
+     -e CURRENCY=NB \
+     -v libeufin_data:/libeufin-data \
+     -p 5016:5016 \
+     -it nlnet
+In the example above, Docker:
+0.  Sets the admin password to *secret*
+1.  Sets the currency to *NB*
+2.  Stores the database in a *volume*.  This helps to
+    share the database between containers.
+3.  Maps the host's 8080 to the container's 80 port.
+4.  Maps the host's 5016 to the container's 5016 port.
+    That lets the CLI reach Sandbox inside the container,
+    and therefore run the tutorial.
+By success, Web browsers get the UI by visiting localhost:8080!
-This setup stores the database in a Docker *volume*.  The following
-command therefore resets all the data stored by LibEuFin.
+The following command shows how to delete the database,
+by deleting its volume.
 .. code-block:: console
@@ -115,11 +140,11 @@ documentation for further information.
 If Sandbox is running
-Sandbox should now be reachable on the port 5000.  Check it with:
+Sandbox should now be reachable on the port 5016.  Check it with:
 .. code-block:: console
-   $ curl http://localhost:5000
+   $ curl http://localhost:5016
 If Sandbox is correctly running, it should respond with a greeting message.
 At this point, the administrator can add a new merchant to the bank with the
@@ -135,7 +160,7 @@ following command.
-   export LIBEUFIN_SANDBOX_URL=http://localhost:5000/
+   export LIBEUFIN_SANDBOX_URL=http://localhost:5016/
    libeufin-cli \

To stop receiving notification emails like this one, please contact

reply via email to

[Prev in Thread] Current Thread [Next in Thread]