Get started

GNUnet is alpha software. Its most mature component, the GNU Name System (GNS), is ready for early adopters; the other applications are still in development.

Three steps take you from nothing to your own GNS zone. If you get stuck, the handbook has the details, and we are happy to help.

1. Install GNUnet

You need a recent release: the protocols still change between major releases (for example from 0.28.x to 0.29.x), and peers of different major versions may be unable to talk to each other. Releases are announced in our news.

From a package

GNUnet is packaged for:

Packages are maintained by the distributions and may be outdated: check that gnunet-arm --version reports the latest release. The Debian and Ubuntu packages are too old to join the current network; please install from source on those systems.

If GNUnet is available for your operating system and missing from this list, let us know. If you would like to package GNUnet, get in touch with us at gnunet-developers@gnu.org.

From source

On Debian 12 or newer, or a recent Ubuntu, install the build dependencies, then download the latest gnunet-VERSION.tar.gz from the GNU FTP mirror and build it:

$ sudo apt install build-essential meson pkgconf gettext \
    libgcrypt20-dev libsodium-dev libgmp-dev libunistring-dev \
    libidn2-dev libltdl-dev libjansson-dev libmicrohttpd-dev \
    libcurl4-gnutls-dev libsqlite3-dev zlib1g-dev libgnutls28-dev \
    libextractor-dev
$ tar xf gnunet-VERSION.tar.gz && cd gnunet-VERSION
$ meson setup --prefix=/usr/local build
$ meson compile -C build
$ sudo meson install -C build && sudo ldconfig

For other systems, the development version, and installations without root privileges, see Installing GNUnet in the handbook.

2. Start your peer

$ gnunet-arm -s

This starts GNUnet in the background; gnunet-arm -e stops it. No configuration file is needed. If your package created a gnunet group, add yourself to it and log in again first.

3. Create your first GNS zone

$ gnunet-identity -C myzone
$ gnunet-namestore -z myzone -a -n www -t A -V 192.0.2.1 -e 1d
$ gnunet-gns -u www.myzone

You now own the zone myzone, and the name www.myzone resolves to 192.0.2.1.

Next steps

  • Link to a friend's zone and publish your own: the quick start continues where this page ends.
  • Use GNS names in your browser and other applications: GNS integration.
  • Keep your peer running and check that it is connected: Running your peer.
  • Explore GNUnet's other applications, which are still in development.