FAQs ==== General ------- General questions about the project. What do I do if my question is not answered here? A: There are many other sources of information. You can read additional documentation or ask the question on the help-gnunet@gnu.org mailing list. When are you going to release the next version? A: The general answer is, when it is ready. A better answer may be: earlier if you contribute (test, debug, code, document). Every release will be anounced on the info-gnunet@gnu.org mailing list and on planet GNU. You can subscribe to the mailing list or the RSS feed of this site to automatically receive a notification. Is the code free? A: GNUnet is free software, available under the GNU Affero Public License (AGPL). Are there any known bugs? A: We track the list of currently known bugs in the Mantis system. Some bugs are occasionally reported directly to developers or the developer mailing list. This is discouraged since developers often do not have the time to feed these bugs back into the Mantis database. Please report bugs directly to the bug tracking system. If you believe a bug is sensitive, you can set its view status to private (this should be the exception). Is there a graphical user interface? A: gnunet-gtk is a separate download. The package contains various GTK+ based graphical interfaces, including a graphical tool for configuration. Why does gnunet-service-nse create a high CPU load? A: The gnunet-service-nse process will initially compute a so-called "proof-of-work" which is used to convince the network that your peer is real (or, rather, make it expensive for an adversary to mount a Sybil attack on the network size estimator). The calculation is expected to take a few days, depending on how fast your CPU is. If the CPU load is creating a problem for you, you can set the value "WORKDELAY" in the "nse" section of your configuration file to a higher value. The default is "5 ms". How does GNUnet compare to Tor? A: Tor focuses on anonymous communication and censorship-resistance for TCP connections and, with the Tor Browser Bundle, for the Web in particular. GNUnet does not really have one focus; our theme is secure decentralized networking, but that is too broad to be called a focus. How does GNUnet compare to I2P? A: Both GNUnet and I2P want to build a better, more secure, more decentralized Internet. However, on the technical side, there are almost no overlaps. I2P is written in Java, and has (asymmetric) tunnels using onion (or garlic) routing as the basis for various (anonymized) applications. I2P is largely used via a Web frontend. Is GNUnet ready for use on production systems? A: Not yet. GNUnet is alpha software and the network protocols still change between major releases. The most mature component is the GNU Name System (GNS), which is ready for early adopters: start with the :doc:`quickstart`. The other applications are still in development. See :doc:`status` for details. Is GNUnet build using distributed ledger technologies? A: No. GNUnet is a new network protocol stack for building secure, distributed, and privacy-preserving applications. While a ledger could be built using GNUnet, we currently have no plans in doing so. Features -------- What can I do with GNUnet? A: GNUnet is a peer-to-peer framework, by which we mostly mean that it can do more than just one thing. Naturally, the implementation and documentation of some of the features that exist are more advanced than others. The most mature is the :doc:`GNU Name System `, a fully decentralized and censorship-resistant alternative to DNS. In development are a self-sovereign identity provider (re:claimID), decentralized messaging, anonymous and non-anonymous file-sharing, and a mechanism for IPv4-IPv6 protocol translation and tunneling (NAT-PT with DNS-ALG). See :doc:`status`. Is it possible to surf the WWW anonymously with GNUnet? A: It is not possible use GNUnet for anonymous browsing at this point. We recommend that you use Tor for anonymous surfing. Is it possible to access GNUnet via a browser as an anonymous WWW? A: There is currently no proxy (like fproxy in Freenet) for GNUnet that would make it accessible via a browser. It is possible to build such a proxy and all one needs to know is the protocol used between the browser and the proxy and the GNUnet code for file-sharing. Is there a graphical user interface? A: There are actually a few graphical user interfaces for different functions. gnunet-setup is to configure GNUnet, and gnunet-fs-gtk is for file-sharing. There are a few other gnunet-XXX-gtk GUIs of lesser importance. Note that in order to obtain the GUI, you need to install the gnunet-gtk package, which is a separate download. gnunet-gtk is a meta GUI that integrates most of the other GUIs in one window. One exception is gnunet-setup, which must still be run separately at this time (as setup requires the peer to be stopped). Which operating systems does GNUnet run on? A: GNUnet is being developed and tested primarily under Debian GNU/Linux. Furthermore, we regularly build and test GNUnet on Fedora, Ubuntu, Arch, FreeBSD and macOS. We have reports of working versions on many other GNU/Linux distributions; in the past we had reports of working versions on NetBSD, OpenBSD and Solaris. However, not all of those reports are recent, so if you cannot get GNUnet to work on those systems please let us know. GNU Name System --------------- Questions about the GNU Name System are answered in :ref:`gns-faq`. Error messages -------------- Error opening ``/dev/net/tun: No such file or directory``? A: If you get this error message, the solution is simple. Issue the following commands (as root) to create the required device file :: # mkdir /dev/net # mknod /dev/net/tun c 10 200 ``iptables: No chain/target/match by that name.`` (when running ``gnunet-service-dns``)? A: For GNUnet DNS, your iptables needs to have "owner" match support. This is accomplished by having the correct kernel options. Check if your kernel has ``CONFIG_NETFILTER_XT_MATCH_OWNER`` set to either ``y`` or ``m`` (and the module is loaded). ``Timeout was reached`` when running PT on Fedora (and possibly others)? A: If you get an error stating that the VPN timeout was reached, check if your firewall is enabled and blocking the connections. I'm getting an ``error while loading shared libraries: libgnunetXXX.so.X`` A: This error usually occurs when your linker fails to locate one of GNUnet's libraries. This can have two causes. First, it is theoretically possible that the library is not installed on your system; however, if you compiled GNUnet the normal way and/or used a binary package, that is highly unlikely. The more common cause is that you installed GNUnet to a directory that your linker does not search. There are several ways to fix this that are described below. If you are ``root`` and you installed to a system folder (such as ``/usr/local``), you want to add the libraries to the system-wide search path. This is done by adding a line ``/usr/local/lib/`` to ``/etc/ld.so.conf`` and running "ldconfig". If you installed GNUnet to ``/opt`` or any other similar path, you obviously have to change ``/usr/local`` accordingly. If you do not have ``root`` rights or if you installed GNUnet to say ``/home/$USER/``, then you can explicitly tell your linker to search a particular directory for libraries using the ``LD_LIBRARY_PATH`` environment variable. For example, if you configured GNUnet using a prefix of ``$HOME/gnunet/`` you want to run: :: $ export LD_LIBRARY_PATH=$HOME/gnunet/lib:$LD_LIBRARY_PATH $ export PATH=$HOME/gnunet/bin:$PATH to ensure GNUnet's binaries and libraries are found. In order to avoid having to do so each time, you can add the above lines (without the "$") to your .bashrc or .profile file. You will have to logout and login again to have this new profile be applied to all shells (including your desktop environment). What error messages can be ignored? A: Error messages flagged as ``DEBUG`` should be disabled in binaries built for end-users and can always be ignored. Error messages flagged as ``INFO`` always refer to harmless events that require no action. For example, GNUnet may use an ``INFO`` message to indicate that it is currently performing an expensive operation that will take some time. GNUnet will also use ``INFO`` messages to display information about important configuration values. File-sharing ------------ How does GNUnet compare to other file-sharing applications? A: As opposed to Napster, Gnutella, Kazaa, FastTrack, eDonkey and most other P2P networks, GNUnet was designed with security in mind as the highest priority. We intend on producing a network with comprehensive security features. Many other P2P networks are open to a wide variety of attacks, and users have little privacy. GNUnet is also Free Software and thus the source code is available, so you do not have to worry about being spied upon by the software. The following table summarises the main differences between GNUnet and other systems. The information is accurate to the best of our knowledge. The comparison is difficult since there are sometimes differences between various implementations of (almost) the same protocol. In general, we pick a free implementation as the reference implementation since it is possible to inspect the free code. Also, all of these systems are changing over time and thus the data below may not be up-to-date. If you find any flaws, please let us know. Finally, the table is not saying terribly much (it is hard to compare these systems this briefly), so if you want the real differences, read the research papers (and probably the code). +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Net- | GNUnet| One | Nap- | Direct| Fast | e- | Gnu- | Free- | | work | FS | Swarm | ster | Co- | Track | Donkey| tella | net | | | | | | nnect | | | | | | | | | | | | | | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Distri| yes | yes | no | hubs | s | DHT | yes | yes | | buted | | | | | uper- | (e | | | | Quer- | | | | | peers | Mule) | | | | ies | | | | | | | | | | | | | | | | | | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Multi-| yes | yes | no | no | yes | yes | yes | no | | source| | | | | | | | | | Down- | | | | | | | | | | load | | | | | | | | | | | | | | | | | | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Econ- | yes | yes | no | no | no | yes | no | no | | omics | | | | | | | | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Anon- | yes | maybe | no | no | no | no | no | yes | | ymity | | | | | | | | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Lan- | C | Java | often | C++ | C | C++ | often | Java | | guage | | | C | | | | C | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Trans-| UDP, | TCP | TCP | TCP? | UDP, | UDP, | TCP | TCP | | port | TCP, | | | | TCP | TCP | | | | Proto-| SMTP, | | | | | | | | | col | HTTP | | | | | | | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Query | key | fil | key | file | file | file | file | s | | Format| words | ename | words | name, | name, | name, | name, | ecret | | (UI) | / CHK | / | | THEX | SHA | MD4? | SHA | key, | | | | SHA? | | | | | | CHK | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Rout- | dy- | | | | | | | | | ing | namic | static| always| always| always| always| always| always| | | (in- | (in- | | | | | | in- | | | direct| direct| direct| direct| direct| direct| direct| direct| | | di- | di- | | | | | | | | | rect) | rect) | | | | | | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ | Licen-| GPL | GPL | GPL | GPL | GPL | GPL | GPL | GPL | | se | | | (knap | (Val | (giFT)| (e- | (gtk | | | | | | ster) | knut) | | Mule) | -gnut | | | | | | | | | | ella) | | +-------+-------+-------+-------+-------+-------+-------+-------+-------+ Another important point of reference are the various anonymous peer-to-peer networks. Here, there are differences in terms of application domain and how specifically anonymity is achieved. Anonymous routing is a hard research topic, so for a superficial comparison like this one we focus on the latency. Another important factor is the programming language. Type-safe languages may offer certain security benefits; however, this may come at the cost of significant increases in resource consumption which in turn may reduce anonymity. Are there any known attacks (on GNUnet's file-sharing application)? A: Generally, there is the possibility of a known plaintext attack on keywords, but since the user has control over the keywords that are associated with the content he inserts, the user can take advantage of the same techniques used to generate reasonable passwords to defend against such an attack. In any event, we are not trying to hide content; thus, unless the user is trying to insert information into the network that can only be shared with a small group of people, there is no real reason to try to obfuscate the content by choosing a difficult keyword anyway. What do you mean by anonymity? A: Anonymity is the lack of distinction of an individual from a (large) group. A central goal for anonymous file-sharing in GNUnet is to make all users (peers) form a group and to make communications in that group anonymous, that is, nobody (but the initiator) should be able to tell which of the peers in the group originated the message. In other words, it should be difficult to impossible for an adversary to distinguish between the originating peer and all other peers. What does my system do when participating in GNUnet file sharing? A: In GNUnet you set up a node (a peer). It is identified by an ID (hash of its public key) and has a number of addresses it is reachable by (may have no addresses, for instance when it's behind a NAT). You specify bandwidth limits (how much traffic GNUnet is allowed to consume) and datastore quote (how large your on-disk block storage is) . Your node will then proceed to connect to other nodes, becoming part of the network. Contributing ------------ How can I help translate this webpage into other languages? A: First, you need to register an account with our weblate system. Please send an e-mail with the desired target language to translators@gnunet.org or ask for help on the #gnunet chat on irc.freenode.net. Typically someone with sufficient permissions will then grant you access. Naturally, any abuse will result in the loss of permissions. I have some great idea for a new feature, what should I do? A: Sadly, we have many more feature requests than we can possibly implement. The best way to actually get a new feature implemented is to do it yourself --- and to then send us a patch.