From 4fdffc7ef04de5a94dd21bb800858b809781dde6 Mon Sep 17 00:00:00 2001 From: Jeff Becker Date: Thu, 13 Apr 2017 08:20:33 -0400 Subject: [PATCH] add docs about floodfill bootstrap --- docs/tutorials/floodfill-bootstrap.md | 17 +++++++++++++++++ mkdocs.yml | 13 +++++++------ 2 files changed, 24 insertions(+), 6 deletions(-) create mode 100644 docs/tutorials/floodfill-bootstrap.md diff --git a/docs/tutorials/floodfill-bootstrap.md b/docs/tutorials/floodfill-bootstrap.md new file mode 100644 index 0000000..2e126c2 --- /dev/null +++ b/docs/tutorials/floodfill-bootstrap.md @@ -0,0 +1,17 @@ +Bootstrapping without Reseed Servers +============================================== + +In some cases i2p's default reseed servers (servers used to fill i2p router's netdb with initial peers) are blocked. + +I2PD has a unique feature that allows it to bootstrap off of any i2p router that is participating in the DHT, they are called floodfill routers and have the router capacity `f` in their router info. + +## How To + +* obtain a `router.info` file of a floodfill router out of band, save to `/tmp/floodfill.router.info` or some other path +* run `i2pd --reseed.floodfill=/tmp/floodfill.router.info` and if that router is online you'll be able to bootstrap into the network from just that routers + +## Caviets + +* The floodfill *must* be trustworthy, it could give you all colluding peers if it's a baddie. +* *DO NOT* use a random floodfill unless you don't care about high security and just want to test out this feature. +* Java I2P routers seem to dislike this feature (sometimes) and may back off exponentially diff --git a/mkdocs.yml b/mkdocs.yml index a7b26c5..c5c2b02 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -9,7 +9,7 @@ site_favicon: media/i2pd-logo.png pages: - Home: index.md -- User Guide: +- User Guide: - Installing: user-guide/install.md - Running: user-guide/run.md - Configuring: user-guide/configuration.md @@ -20,24 +20,25 @@ pages: - Anonymous websites: tutorials/http.md - Anonymous IRC chats: tutorials/irc.md - Filesharing: tutorials/filesharing.md - - Using RetroShare with i2pd: tutorials/retroshare.md + - Using RetroShare with i2pd: tutorials/retroshare.md + - Bootstrapping without Reseed Servers: tutorials/floodfill-bootstrap.md - Developer Section: - - Building from source: + - Building from source: - Requirements: devs/building/requirements.md - Unix: devs/building/unix.md - Windows: devs/building/windows.md - Android: devs/building/android.md - Cross-platform: devs/building/cross.md - iOS: devs/building/ios.md - - API: + - API: - Choosing API for your project: devs/api/index.md - SAM: devs/api/SAM.md - BOB: devs/api/BOB.md - - I2CP: devs/api/I2CP.md + - I2CP: devs/api/I2CP.md - I2PControl: devs/api/I2PControl.md - libi2pd: devs/api/libi2pd.md - Hacking the code: devs/hacking.md -- About: +- About: - Community: about/community.md - History: about/history.md - License: about/license.md