taler-docs

commit b35bb74a826d74018f9d5b3ac4856a1abe57c966
parent 9fa2be0bf07201742e0c9eda1424b8a72151296f
Author: Christian Grothoff <christian@grothoff.org>
Date:   Tue, 26 Jan 2021 12:07:33 +0100

add Ubuntu instructions for merchant

Diffstat:
A
frags/installing-ubuntu.rst
 | 
37
+++++++++++++++++++++++++++++++++++++
M
taler-merchant-manual.rst
 | 
19
+++++++++++++++++++

2 files changed, 56 insertions(+), 0 deletions(-)
diff --git a/frags/installing-ubuntu.rst 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
@@ -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