Publishing and sharing your zone
A zone becomes useful to others once they can find it. This page explains how to publish records, how to hand out your zone key, and how to get a name for your zone that other GNUnet users can resolve without any setup.
Publishing records
Only records marked as public are published. Add -p when you create
a record:
$ gnunet-namestore -z myzone -a -p -n www -t A -V 192.0.2.1 -e 1d
Your peer signs and encrypts public records and stores them in the GNUnet DHT, and republishes them regularly while it is running. Keep your peer running (see Running your peer): if it stays offline, your records eventually expire from the network.
Registering a name under .pin.gns.alt
Every GNUnet installation is configured with the start zone
.pin.gns.alt, a registry operated by GNUnet e.V. on a first-come,
first-served basis. If you register myname there, every GNUnet user can
resolve your records as www.myname.pin.gns.alt without exchanging keys
first.
To register, visit https://fcfs.gnunet.org and register your zone key under a name of your choice. The registrar is connected to the demo deployment of GNU Taler and asks for a payment in KUDOS, a demo currency you get for free when you register at the Taler demo; the service is therefore effectively free.
Keep in mind that names in .pin.gns.alt are only as trustworthy as the
registry: whoever operates it could, in principle, change the delegation.
For names that matter, exchange keys directly as well.
Business cards and QR codes
GNUnet includes gnunet-bcd, which creates printable business cards with
a QR code of your zone key, and gnunet-qr, which reads such a code with
a camera and imports the zone.
Warning
In GNUnet 0.29, importing a zone from a QR code does not work: the
import step (gnunet-namestore -u) fails for current zone keys.
Exchange keys as text, as shown above, until this is fixed.
gnunet-bcd is a small web application. It needs a LaTeX installation
with the units, labels, pst-barcode, luatex85, preview,
pdfcrop and koma-script packages (on Debian, texlive-full
contains all of them). Start it, then open http://localhost:8888/ in a
browser and fill in the form, including your zone key:
$ gnunet-arm -i bcd
The result is a PDF with ten business cards.
The default start zones
The start zones configured by default, such as .pin.gns.alt, are
registered in GANA and follow a restrictive
registration policy.
Every user can remove them or add others; see Concepts.
Running your own registrar
The software behind https://fcfs.gnunet.org is available as a separate package, the GNUnet GNS registrar, from the GNU FTP mirror. Build and run it with:
$ ./configure && make
$ ./gnunet-gns-registrar
It requires a GNU Taler merchant backend for payments; see the example configuration in the package for the available options.