Moneropedia

Address Book

The Basics

In order to browse I2P sites or services with Kovri, you'll need an address book. An address book will allow you to translate I2P websites/services that use the .i2p top-level domain into an address that I2P network will understand.

Without an address book, you would be stuck using a Base32 address every time you visit an I2P website/service - and that's not fun!

In-depth information

Since DNS does not exist on the I2P network, Kovri also does not use DNS or any sort of Canonically unique host resolution. Instead, Kovri pairs a Locally unique host to a Base64 address Destination in a Subscription. Once your address book is filled with a Subscription, you can resolve your favorite .i2p domain site into a usable I2P destination.

Creating an Address Book

By default, your installation will come with a default public Subscription called hosts.txt in your Data Directory. When Kovri starts, it loads this subscription and fetches any other subscriptions you've specified. Once loaded, your address book will be appropriately filled. For details on how to manage subscriptions, see Subscription.

Updating the Address Book

Currently, there are several ways to update your address book:

  1. Use a Jump Service to insert I2P addresses into your address book
  2. Use a Jump Service to copy/paste an address into your private Subscription
  3. Manually add or subtract from a private Subscription

Note: Kovri is in heavy development. In the future there will be easier ways to update the address book

Address Book / Naming specification

For specification details and more, visit the Address Book and Naming Specification