Note
Currently, GNU Anastasis is released as alpha-quality software.
When testing Anastasis, please choose demoland as
your country of residence!
It is not yet production ready! You cannot rely on it to keep
your secrets recoverable today! In particular, we need to
still review the various country-specific questions used to create
unique user identifiers at the beginning of the backup and
recovery process. Community feedback on those inputs would be
particularly welcome!
Please install the following packages before proceeding with the exchange compilation.
Except for the last two, these are available in most GNU/Linux distributions and should just be installed using the respective package manager.
The following instructions will show how to install libgnunetutil and the GNU Taler exchange from source.
Before you install GNUnet, you must download and install the dependencies mentioned in the previous section, otherwise the build may succeed, but could fail to export some of the tooling required by GNU Taler.
To install GNUnet, unpack the tarball and change into the resulting directory, then proceed as follows:
$ ./configure [--prefix=GNUNETPFX]
$ # Each dependency can be fetched from non standard locations via
$ # the '--with-<LIBNAME>' option. See './configure --help'.
$ make
# make install
# ldconfig
If you did not specify a prefix, GNUnet will install to /usr/local,
which requires you to run the last step as root.
The ldconfig command (also run as root) makes the
shared object libraries (.so files)
visible to the various installed programs.
After installing GNUnet, unpack the GNU Taler exchange tarball, change into the resulting directory, and proceed as follows:
$ ./configure [--prefix=EXCHANGEPFX] \
[--with-gnunet=GNUNETPFX]
$ # Each dependency can be fetched from non standard locations via
$ # the '--with-<LIBNAME>' option. See './configure --help'.
$ make
# make install
If you did not specify a prefix, the exchange will install to /usr/local,
which requires you to run the last step as root. You have to specify
--with-gnunet=/usr/local if you installed GNUnet to /usr/local in the
previous step.
GNU Taler merchant has these additional dependencies:
The following steps assume all dependencies are installed.
First, unpack the GNU Taler merchant tarball and change into the resulting directory. Then, use the following commands to build and install the merchant backend:
$ ./configure [--prefix=PFX] \
[--with-gnunet=GNUNETPFX] \
[--with-exchange=EXCHANGEPFX]
$ # Each dependency can be fetched from non standard locations via
$ # the '--with-<LIBNAME>' option. See './configure --help'.
$ make
# make install
If you did not specify a prefix, the exchange will install to
/usr/local, which requires you to run the last step as root.
You have to specify --with-exchange=/usr/local and/or
--with-gnunet=/usr/local if you installed the exchange and/or
GNUnet to /usr/local in the previous steps.
Depending on the prefixes you specified for the installation and the
distribution you are using, you may have to edit /etc/ld.so.conf, adding
lines for GNUNETPFX/lib/ and EXCHANGEPFX/lib/ and PFX/lib/
(replace the prefixes with the actual paths you used). Afterwards, you should
run ldconfig. Without this step, it is possible that the linker may not
find the installed libraries and launching the Taler merchant backend would
then fail.
The following steps assume all dependencies are installed.
First, unpack the Anastasis tarball and change into the resulting directory. Then, use the following commands to build and install Anastasis:
$ ./configure [--prefix=PFX] \
[--with-gnunet=GNUNETPFX] \
[--with-exchange=EXCHANGEPFX]
$ # Each dependency can be fetched from non standard locations via
$ # the '--with-<LIBNAME>' option. See './configure --help'.
$ make
# make install
If you did not specify a prefix, Anastasis will be installed to
/usr/local, which requires you to run the last step as root.
You have to specify --with-exchange=/usr/local and/or
--with-gnunet=/usr/local if you installed the exchange and/or
GNUnet to /usr/local in the previous steps.
Depending on the prefixes you specified for the installation and the
distribution you are using, you may have to edit /etc/ld.so.conf, adding
lines for GNUNETPFX/lib/ and EXCHANGEPFX/lib/ and PFX/lib/
(replace the prefixes with the actual paths you used). Afterwards, you should
run ldconfig. Without this step, it is possible that the linker may not
find the installed libraries and launching the Anastasis backend would
then fail.
The following steps assume at least the GNUnet and Gtk+ dependencies are installed.
First, unpack the gnunet-gtk tarball and change into the resulting directory. Then, use the following commands to build and install gnunet-gtk:
$ ./configure [--prefix=$PFX] \
[--with-gnunet=$GNUNETPFX]
$ # Each dependency can be fetched from non standard locations via
$ # the '--with-<LIBNAME>' option. See './configure --help'.
$ make
# make install
It is highly recommended to use the same prefix ($PFX) for gnunet-gtk that was
used for GNUnet ($GNUNETPFX). If you did not specify a prefix, gnunet-gtk
will be installed to /usr/local, which requires you to run the last step
as root.
You have to specify --with-gnunet=/usr/local if you installed
GNUnet to /usr/local in the previous steps.
Depending on the prefixes you specified for the installation and the
distribution you are using, you may have to edit /etc/ld.so.conf, adding
lines for $GNUNETPFX/lib/ and $PFX/lib/ (replace the prefixes with the
actual paths you used). Afterwards, you should run ldconfig. Without this
step, it is possible that the linker may not find the installed libraries and
launching gnunet-gtk would then fail.
The following steps assume at least the GNUnet, gnunet-gtk and Anastasis dependencies are installed.
First, unpack the anastasis-gtk tarball and change into the resulting directory. Then, use the following commands to build and install anastasis-gtk:
$ ./configure [--prefix=PFX] \
[--with-gnunet=GNUNETPFX] \
[--with-exchange=EXCHANGEPFX] \
[--with-anastasis=ANASTASISPFX]
$ # Each dependency can be fetched from non standard locations via
$ # the '--with-<LIBNAME>' option. See './configure --help'.
$ make
# make install
If you did not specify a prefix, anastasis-gtk will be installed to
/usr/local, which requires you to run the last step as root.
You have to specify -with-anastasis=/usr/local, --with-exchange=/usr/local and/or
--with-gnunet=/usr/local if you installed the exchange and/or
GNUnet to /usr/local in the previous steps.
Depending on the prefixes you specified for the installation and the
distribution you are using, you may have to edit /etc/ld.so.conf, adding
lines for GNUNETPFX/lib/ and EXCHANGEPFX/lib/ and PFX/lib/
(replace the prefixes with the actual paths you used). Afterwards, you should
run ldconfig. Without this step, it is possible that the linker may not
find the installed libraries and launching anastasis-gtk would then fail.
To install the GNU Taler Debian packages, first ensure that you have the right Debian distribution. At this time, the packages are built for Bullseye.
You need to add a file to import the GNU Taler packages. Typically,
this is done by adding a file /etc/apt/sources.list.d/taler.list that
looks like this:
deb https://deb.taler.net/apt/debian bullseye main
Next, you must import the Taler Systems SA public package signing key into your keyring and update the package lists:
# wget -O - https://taler.net/taler-systems.gpg.key | apt-key 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.
To install the Anastasis Gtk+ frontend, you can simply run:
# apt install anastasis-gtk
To use anastasis-gtk, you can simply run:
$ anastasis-gtk
If you want to install the Anastasis backend-end (which normal users do not need), you should run:
# apt install -t sid anastasis-httpd
Note that the latter package does not perform all of the configuration work. It does setup the user users and the systemd service scripts, but you still must configure the database backup, HTTP reverse proxy (typically with TLS certificates), Taler merchant backend for payments, authentication services, prices and the terms of service.
Sample configuration files for the HTTP reverse proxy can be found in
/etc/anastasis.conf.
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/anastasis.conf.
To operate an Anastasis backend with payments, you additionally need to install a Taler merchant backend via:
# apt install -t sid taler-merchant-httpd
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.d/taler.list file for this setup
would look like this:
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:
# wget -O - https://taler.net/taler-systems.gpg.key | apt-key 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.
To install the Anastasis front-end, you can now simply run:
# apt install -t focal-fossa anastasis-gtk
To use anastasis-gtk, you can simply run:
$ anastasis-gtk
If you want to install the Anastasis backend-end (which normal users do not need), you should run:
# apt install -t focal-fossa anastasis-httpd
Note that the latter package does not perform all of the configuration work. It does setup the user users and the systemd service scripts, but you still must configure the database backup, HTTP reverse proxy (typically with TLS certificates), Taler merchant backend for payments, authentication services, prices and the terms of service.
Sample configuration files for the HTTP reverse proxy can be found in
/etc/anastasis.conf.
To operate an Anastasis backend with payments, you additionally need to install a Taler merchant backend via:
# apt install -t sid taler-merchant-httpd