From 7ea4ea6d96443b20c7b22bc22d1e21a71893f659 Mon Sep 17 00:00:00 2001 From: lash Date: Wed, 2 Nov 2022 18:08:47 +0000 Subject: [PATCH] Manually connecting peers, default hellos Signed-off-by: lash --- users/configuration.rst | 45 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/users/configuration.rst b/users/configuration.rst index 5cedfdc..2db37c3 100644 --- a/users/configuration.rst +++ b/users/configuration.rst @@ -382,6 +382,7 @@ If you want to operate in normal P2P-only mode, simply set ``MINIMUM-FRIENDS`` to zero and ``FRIENDS_ONLY`` to NO. This is the default. + .. _Configuring-the-hostlist-to-bootstrap: Configuring the hostlist to bootstrap @@ -458,6 +459,50 @@ So your configuration file should include these lines: SERVERS = http://v10.gnunet.org/hostlist [^] HOSTLISTFILE = $SERVICEHOME/hostlists.file + +.. _Disable_default_bootstrap: + +Disable default bootstrap (private network) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +A public node will, by default, connect to a gnunet.org peer to learn +of other peers to bootstrap the network. + +To avoid this behavior, either: + +- before build, remove the peer entry in ``$REPO/contrib/hellos`` + +- after build, remove the peer entry in ``$PREFIX/share/gnunet/hellos`` + +Conversely, any public keys added to the same directories will make the +node *always* make explicit connections to those corresponding peers. + + +.. _Manually-connecting-peers: + +Manually connecting peers +~~~~~~~~~~~~~~~~~~~~~~~~~ + +A gnunet node will learn peers to connect to from hostlist servers and/or +gossip from connected peers. It will however only connect to a selection +of peers on the network. + +If you wish to connect to a specific peer apart from the automatically +negotiated connections, you can use the ``hello`` URI of the peer. The +URI is returned by the following command to *peer to be connected to*: + +:: + + $ gnunet-peerinfo -s -g + +The URI output is passed to the ``gnunet-peerinfo`` command of *peer +that is connecting*: + +:: + + $ gnunet-peerinfo -s -p URI + + .. _Configuration-of-the-HOSTLIST-proxy-settings-cli: Configuration of the HOSTLIST proxy settings -- 2.38.0