diff options
author | Christian Grothoff <christian@grothoff.org> | 2021-01-26 12:07:33 +0100 |
---|---|---|
committer | Christian Grothoff <christian@grothoff.org> | 2021-01-26 12:07:33 +0100 |
commit | b35bb74a826d74018f9d5b3ac4856a1abe57c966 (patch) | |
tree | a828213e3d52f4f567ddc382235408f153ee52b4 | |
parent | 9fa2be0bf07201742e0c9eda1424b8a72151296f (diff) | |
download | docs-b35bb74a826d74018f9d5b3ac4856a1abe57c966.tar.gz docs-b35bb74a826d74018f9d5b3ac4856a1abe57c966.tar.bz2 docs-b35bb74a826d74018f9d5b3ac4856a1abe57c966.zip |
add Ubuntu instructions for merchant
-rw-r--r-- | frags/installing-ubuntu.rst | 37 | ||||
-rw-r--r-- | taler-merchant-manual.rst | 19 |
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 |