summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMartin Schanzenbach <schanzen@gnunet.org>2024-03-11 09:48:35 +0100
committerMartin Schanzenbach <schanzen@gnunet.org>2024-03-11 09:48:35 +0100
commit9d13376aa9ad537d04966a36eee3c1a16dafaa10 (patch)
treed9fdf96bd4ff13364fa80adb4d62f9e2490a9cc4
parent01f5773ea7bede7adcf8a055cd9baec3aaa52897 (diff)
downloadgnunet-handbook-9d13376aa9ad537d04966a36eee3c1a16dafaa10.tar.gz
gnunet-handbook-9d13376aa9ad537d04966a36eee3c1a16dafaa10.zip
remove f2f, clarify bootstrap
-rw-r--r--users/configuration.rst49
1 files changed, 13 insertions, 36 deletions
diff --git a/users/configuration.rst b/users/configuration.rst
index 5d99db0..fcdcf17 100644
--- a/users/configuration.rst
+++ b/users/configuration.rst
@@ -340,49 +340,26 @@ exists (!). An alternative name for the \"gnunetdns\" group can be
340specified using the ``--with-gnunetdns=GRPNAME`` configure option. 340specified using the ``--with-gnunetdns=GRPNAME`` configure option.
341 341
342 342
343.. _Configuring-the-Friend_002dto_002dFriend-_0028F2F_0029-mode: 343Configuring dropshipped HELLOs to bootstrap
344
345Configuring the Friend-to-Friend (F2F) mode
346~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 344~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
347 345
348GNUnet knows three basic modes of operation: 346GNUnet by default tries to bootstrap using included hellos and a hostlist
349 347server.
350- In standard \"peer-to-peer\" mode, your peer will connect to any 348The HELLOs that GNUnet tries to bootstrap with can be found in the directory
351 peer. 349``$PREFIX/share/gnunet/hellos``.
352 350The use of the HELLOs in this folder can be controlled with the configuration
353- In the pure \"friend-to-friend\" mode, your peer will ONLY connect to 351setting ``USE_INCLUDED_HELLOS`` of the ``peerstore`` service:
354 peers from a list of friends specified in the configuration.
355
356- Finally, in mixed mode, GNUnet will only connect to arbitrary peers
357 if it has at least a specified number of connections to friends.
358
359When configuring any of the F2F (\"friend-to-friend\") modes, you first
360need to create a file with the peer identities of your friends. Ask your
361friends to run
362 352
363.. code-block:: text 353.. code-block:: text
364 354
365 $ gnunet-peerinfo -sq 355 $ gnunet-config -s peerstore -o USE_INCLUDED_HELLOS
366
367The resulting output of this command needs to be added to your
368``friends`` file, which is simply a plain text file with one line per
369friend with the output from the above command.
370
371You then specify the location of your ``friends`` file in the
372``FRIENDS`` option of the \"topology\" section.
373
374Once you have created the ``friends`` file, you can tell GNUnet to only
375connect to your friends by setting the ``FRIENDS-ONLY`` option (again in
376the \"topology\" section) to YES.
377
378If you want to run in mixed-mode, set \"FRIENDS-ONLY\" to NO and
379configure a minimum number of friends to have (before connecting to
380arbitrary peers) under the \"MINIMUM-FRIENDS\" option.
381 356
382If you want to operate in normal P2P-only mode, simply set 357Note, however, that once the included HELLOs have been parsed, the ``peerstore``
383``MINIMUM-FRIENDS`` to zero and ``FRIENDS_ONLY`` to NO. This is the 358will cache them locally in its databse. To purge included HELLOs in this case,
384default. 359the database will have to be deleted.
385 360
361Unless you want to establish a private network, you should not have to touch
362this option.
386 363
387.. _Configuring-the-hostlist-to-bootstrap: 364.. _Configuring-the-hostlist-to-bootstrap:
388 365