+======================================================================
+
+THIS SVN VERSION OF GNUNET IS INCOMPATIBLE TO ALL PREVIOUS RELEASES.
+WE ARE WORKING ON CHANGING FUNDAMENTAL PARTS OF THE CRYPTOGRAPHIC
+PARTS OF THE SYSTEM.
+
+You need to install libgcrypt from git master (1.6.0beta93 at least)
+for the code to compile.
+
+=======================================================================
+
Welcome to GNUnet
currently developed by a worldwide group of independent free software
developers. GNUnet is a GNU package (http://www.gnu.org/).
-This is an ALPHA release. There are known and significant bugs as
-well as many missing features in this release.
+This is an ALPHA release. There are known and significant bugs as
+well as many missing features in this release.
Additional documentation about GNUnet can be found at
https://gnunet.org/.
These are the direct dependencies for running GNUnet:
- libextractor >= 0.6.1
-- libmicrohttpd >= 0.9.18
+- libmicrohttpd >= 0.9.31
- libgcrypt >= 1.2
- libcurl >= 7.21.3
- libunistring >= 0.9.2
- gnutls >= 2.12.0
+- libidn >= 1.0
+- openssl >= 1.0 (binary, used to generate X.509 certificate)
- libltdl >= 2.2 (part of GNU libtool)
-- sqlite >= 3.0 (default database)
-- mysql >= 5.1 (alternative to sqLite)
-- postgres >= 8.3 (alternative to sqLite)
+- sqlite >= 3.8 (default database, required)
+- mysql >= 5.1 (alternative to sqlite)
+- postgres >= 8.3 (alternative to sqlite)
+- libopus >= 0.9.14 (optional for experimental conversation tool)
+- libpulse >= 2.0 (optional for experimental conversation tool)
Recommended autotools for compiling the SVN version are:
- autoconf >= 2.59
- automake >= 1.11.1
-- libtool >= 2.2
+- libtool >= 2.2
How to install?
actual GNUnet compilation and installation process with:
$ export GNUNET_PREFIX=/usr/local # or other directory of your choice
-$ addgroup gnunetdns
-$ adduser gnunet gnunet
-$ ./configure --prefix=$GNUNET_PREFIX --with-extractor=$LE_PREFIX
+# addgroup gnunetdns
+# adduser gnunet gnunet
+# ./configure --prefix=$GNUNET_PREFIX --with-extractor=$LE_PREFIX
$ make
# make install
# sudo -u gnunet gnunet-arm -s
+Note that running the 'configure' and 'make install' steps as
+root (or with sudo) is required as some parts of the installation
+require the creation of SUID binaries. The installation will
+work if you do not run these steps as root, but some components
+may not be installed in the perfect place or with the right
+permissions and thus won't work.
+
This will create the users and groups needed for running GNUnet
securely and then compile and install GNUnet to $GNUNET_PREFIX/bin/,
$GNUNET_PREFIX/lib/ and $GNUNET_PREFIX/share/ and start the system
with the default configuration. It is strongly recommended that you
add a user "gnunet" to run "gnunet-arm". You can then still run the
-end-user applications as another user.
+end-user applications as another user.
If you create a system user "gnunet", it is recommended that you edit
the configuration file slightly so that data can be stored in the
(can run "chmod +s" and "chown" via 'sudo'). If you run 'make install'
as a normal user without sudo rights (or the configure option),
certain binaries that require additional priviledges will not be
-installed properly (and autonomous NAT traversal, WLAN, DNS/GNS and
+installed properly (and autonomous NAT traversal, WLAN, DNS/GNS and
the VPN will then not work).
If you run 'configure' and 'make install' as root or use the SUDO
The GTK user interface is shipped separately. After downloading and
-installing gnunet-gtk, you can invoke the setup tool and the
+installing gnunet-gtk, you can invoke the setup tool and the
file-sharing GUI with:
$ gnunet-setup
$ make check
Some of the testcases require python >= 2.6 and pexpect to be
-installed. If any testcases fail to pass on your system, run
-"contrib/report.sh" and report the output together with
-information about the failing testcase to the Mantis bugtracking
+installed. If any testcases fail to pass on your system, run
+"contrib/report.sh" and report the output together with
+information about the failing testcase to the Mantis bugtracking
system at https://gnunet.org/bugs/.