summaryrefslogtreecommitdiff
path: root/frags
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2021-01-03 23:05:00 +0100
committerChristian Grothoff <christian@grothoff.org>2021-01-03 23:05:00 +0100
commit2a1fcffe436f6e2cfec28e25123e2c6485816ba1 (patch)
tree9cfd710997ec6be172b2a25cc0c861f4449343d7 /frags
parent3b866c6ca19ebdd6a4354b7c0774bd6481afe59a (diff)
downloaddocs-2a1fcffe436f6e2cfec28e25123e2c6485816ba1.tar.gz
docs-2a1fcffe436f6e2cfec28e25123e2c6485816ba1.tar.bz2
docs-2a1fcffe436f6e2cfec28e25123e2c6485816ba1.zip
Debian package instructions
Diffstat (limited to 'frags')
-rw-r--r--frags/installing-debian.rst52
1 files changed, 52 insertions, 0 deletions
diff --git a/frags/installing-debian.rst b/frags/installing-debian.rst
new file mode 100644
index 0000000..1842ca5
--- /dev/null
+++ b/frags/installing-debian.rst
@@ -0,0 +1,52 @@
+To install the GNU Taler Debian packages, you must first ensure to have
+the right Debian distribution. At this time, the packages are build for
+Sid, which means you should use a system which at least includes
+unstable packages in its source list. We recommend using APT pinning
+to limit unstable packages to those explicitly requested. To do this,
+set your ``/etc/apt/preferences`` as follows:
+
+.. code-block::
+
+ Package: *
+ Pin: release a=stable
+ Pin-Priority: 700
+
+ Package: *
+ Pin: release a=testing
+ Pin-Priority: 650
+
+ Package: *
+ Pin: release a=unstable
+ Pin-Priority: 600
+
+ Package: *
+ Pin: release l=Debian-Security
+ Pin-Priority: 1000
+
+A typical ``/etc/apt/sources.list`` file for this setup
+would look like this:
+
+.. code-block::
+
+ deb http://ftp.ch.debian.org/debian/ buster main
+ deb http://security.debian.org/debian-security buster/updates main
+ deb http://ftp.ch.debian.org/debian/ testing main
+ deb http://ftp.ch.debian.org/debian/ unstable main
+ deb https://deb.taler.net/apt/debian sid 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/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.