gnunet-handbook

The GNUnet Handbook
Log | Files | Refs

commit 8151ac32bf601519c503a2db946562dad3dac39f
parent 8bee397cada705b70959c0cb851e6edb51ce8f0b
Author: Martin Schanzenbach <schanzen@gnunet.org>
Date:   Sun, 31 Jul 2022 14:16:36 +0200

start refactoring installation mess

Diffstat:
Minstalling.md | 9+++++++++
Muser.md | 53+++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 62 insertions(+), 0 deletions(-)

diff --git a/installing.md b/installing.md @@ -225,3 +225,12 @@ Now GNS should work in browsers that are configured to use a SOCKS proxy on loca ## Minimal configuration TODO + +## The graphical configuration interface + +TODO move content for this (see texinfo) either into configuration, it its own chapter, or nuke it. +Instructions should include CLI (what comes with gnunet.git) ONLY + +## Config Leftovers + +This needs to be integrated better. It seems like a leftover from another refactoring (see texinfo). diff --git a/user.md b/user.md @@ -22,6 +22,59 @@ $ gnunet-arm -e You can usually find the logs under `~/.cache/gnunet` and all files such as databases and private keys in `~/.local/share/gnunet`. +The list of running services can be displayed using the `-I` option. It should look similar to this example: + +``` +$ gnunet-arm -I +Running services: +topology (gnunet-daemon-topology) +nat (gnunet-service-nat) +vpn (gnunet-service-vpn) +gns (gnunet-service-gns) +cadet (gnunet-service-cadet) +namecache (gnunet-service-namecache) +hostlist (gnunet-daemon-hostlist) +revocation (gnunet-service-revocation) +ats (gnunet-service-ats) +peerinfo (gnunet-service-peerinfo) +zonemaster (gnunet-service-zonemaster) +zonemaster-monitor (gnunet-service-zonemaster-monitor) +dht (gnunet-service-dht) +namestore (gnunet-service-namestore) +set (gnunet-service-set) +statistics (gnunet-service-statistics) +nse (gnunet-service-nse) +fs (gnunet-service-fs) +peerstore (gnunet-service-peerstore) +core (gnunet-service-core) +rest (gnunet-rest-server) +transport (gnunet-service-transport) +datastore (gnunet-service-datastore) +``` + +For the ***multi-user*** setup first the system services need to be started as the system user, i.e. the user gnunet needs to execute `gnunet-arm -s`. +This should be done by the system’s init system. +Then the user who wants to start GNUnet applications has to run `gnunet-arm -s`, too. +It is recommended to automate this, e.g. using the user’s crontab. + +First, you should launch the peer information tool. +You can do this from the command-line by typing: + +``` +$ gnunet-peerinfo +``` + +Once you have done this, you will see a list of known peers. +If hardly any peers are listed, there is likely a problem with your network configuration. +You can also check directly connected peers with: + +``` +$ gnunet-core +``` + +This should return (at least) one established connection peer. +Otherwise, again, there is likely a problem with your network configuration. + ## The GNU Name System The GNU Name System (GNS) is secure and decentralized naming system. It allows its users to register names as top-level domains (TLDs) and resolve other namespaces within their TLDs.