GNS

The GNU Name System

A decentralized, censorship-resistant and privacy-preserving alternative to DNS, specified in RFC 9498. GNS is the most mature part of GNUnet and the best place to start.

Motivation

The Domain Name System today enables traffic amplification attacks, censorship (i.e. China), mass surveillance (MORECOWBELL) and offensive cyber war (QUANTUMDNS).
Unfortunately, band aid solutions such as DoT, DoH, DNSSEC, DPRIVE and the like will not fix this. This is why we built the GNU Name System (GNS), a secure, decentralized name system built on top of GNUnet.

Features

  • Names you own. A zone is a key pair you create yourself. Only the holder of the private key can change its records; there is no registrar that could seize or censor it.
  • No central root. Every user is the root of their own namespace and links to other people's zones under names of their choice.
  • Private lookups. Records are encrypted, and the peers that store and route a query learn neither the name nor the answer.
  • Authentic answers. Every record is signed with the zone key.
  • DNS compatibility. GNS supports the usual DNS record types, can serve unmodified applications, and can import existing DNS zones.

Try it

After installing GNUnet, start your peer, create a zone, add a record and resolve it:

$ gnunet-arm -s
$ 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

To make a friend's zone available under the name alice, add their zone key as a delegation:

$ gnunet-namestore -z myzone -a -n alice -t EDKEY -V ALICES-ZONE-KEY -e 1d
$ gnunet-gns -u www.alice.myzone

The quick start in the handbook walks you through these steps.

GNS compared with DNS

DNSGNS
Who controls a nameregistrar, registry, ICANNthe holder of the zone key
Root of trustone global root zoneeach user's own start zones
Globally unique namesyesno (names are relative to the user)
Query privacyqueries visible to resolvers and serversqueries hidden from the network
Signed recordsoptional (DNSSEC)always

Use it every day

  • Make GNS names work in your browser and other applications with the DNS2GNS bridge.
  • Register a name for your zone under .pin.gns.alt at fcfs.gnunet.org, so that every GNUnet user can resolve it.
  • Mirror an existing DNS zone into GNS with the migration tools.

Status

The protocol is published as RFC 9498 and the API is stable. Managing your own zones and resolving names in them works well. Lookups in other people's zones go through the GNUnet network, which is still small, and can therefore be slow. See what works today.

Resources