summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--frags/installing-ubuntu.rst37
-rw-r--r--taler-merchant-manual.rst19
2 files changed, 56 insertions, 0 deletions
diff --git a/frags/installing-ubuntu.rst b/frags/installing-ubuntu.rst
new file mode 100644
index 00000000..a72579da
--- /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 283512d5..ad8b5130 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