[taler-docs] 03/03: add Ubuntu instructions for merchant

[gnunet]

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

grothoff pushed a commit to branch master
in repository docs.

commit b35bb74a826d74018f9d5b3ac4856a1abe57c966
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Tue Jan 26 12:07:33 2021 +0100

    add Ubuntu instructions for merchant
---
 frags/installing-ubuntu.rst | 37 +++++++++++++++++++++++++++++++++++++
 taler-merchant-manual.rst   | 19 +++++++++++++++++++
 2 files changed, 56 insertions(+)

diff --git a/frags/installing-ubuntu.rst b/frags/installing-ubuntu.rst
new file mode 100644
index 0000000..a72579d
--- /dev/null
+++ b/frags/installing-ubuntu.rst
@@ -0,0 +1,37 @@
+To install the GNU Taler Ubuntu packages, first ensure that you have
+the right Ubuntu distribution. At this time, the packages are built for
+Ubuntu 20.04 LTS (Focal Fossa).
+
+A typical ``/etc/apt/sources.list`` file for this setup
+would look like this:
+
+.. code-block::
+
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal main restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal-updates main restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal-security main restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal universe restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal-updates universe restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal-security universe restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal multiverse restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal-updates multiverse restricted
+   deb http://ch.archive.ubuntu.com/ubuntu/ focal-security multiverse 
restricted
+
+   deb https://deb.taler.net/apt/ubuntu/ focal-fossa main
+
+The last line is crucial, as it adds the GNU Taler packages.
+
+Next, you must import the Taler Systems SA public package signing key
+into your keyring and update the package lists:
+
+.. code-block:: console
+
+   # wget -O - https://taler.net/static/taler-systems.gpg.key | apt-sign add -
+   # apt update
+
+.. note::
+
+   You may want to verify the correctness of the Taler Systems key out-of-band.
+
+Now your system is ready to install the official GNU Taler binary packages
+using apt.
diff --git a/taler-merchant-manual.rst b/taler-merchant-manual.rst
index 283512d..ad8b513 100644
--- a/taler-merchant-manual.rst
+++ b/taler-merchant-manual.rst
@@ -394,6 +394,25 @@ furthermore still configure the instances, and may need to 
extend the fragment
 with access control restrictions for non-default instances.
 
 
+Installing the GNU Taler binary packages on Ubuntu
+--------------------------------------------------
+
+.. include:: frags/installing-ubuntu.rst
+
+To install the Taler merchant backend, you can now simply run:
+
+.. code-block:: console
+
+   # apt install taler-merchant
+
+Note that the package does not complete the integration of the backend with
+the HTTP reverse proxy (typically with TLS certificates).  A configuration
+fragment for Nginx or Apache will be placed in
+``/etc/{apache,nginx}/conf-available/taler-merchant.conf``.  You must
+furthermore still configure the instances, and may need to extend the fragment
+with access control restrictions for non-default instances.
+
+
 .. _Installing-Taler-on-Debian-GNU_002fLinux:
 
 Installing Taler on Debian GNU/Linux from source

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.