Skip to content

Update instructions for i2pd for 10 #3023

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sspencerwire merged 1 commit into from
Nov 10, 2025
Merged

Update instructions for i2pd for 10 #3023

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 10 additions & 13 deletions docs/guides/proxies/i2pd.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,12 @@
---
title: i2pd Anonymous Network
author: Neel Chauhan
contributors:
tested_with: 9.3
contributors: Steven Spencer
tags:
- proxy
- proxies
---

# i2pd Anonymous Network

## Introduction

[I2P](https://geti2p.net/en/) is an anonymous overlay network and competitor to the more-popular Tor network with a focus on hidden websites called eepsites. [`i2pd`](https://i2pd.website/) (I2P Daemon) is a lightweight C++ implementation of the I2P protocol.
Expand All @@ -22,10 +19,10 @@ The following are minimum requirements for using this procedure:

## Installing `i2pd`

To install `i2pd`, you need to first install the EPEL (Extra Packages for Enterprise Linux) and `i2pd` copr (Cool Other Package Repo) repositories (Note: If you are running Rocky Linux 8, substitute in `8` for `9`):
To install `i2pd`, you need to first install the EPEL (Extra Packages for Enterprise Linux) and `i2pd` copr (Cool Other Package Repo) repositories:

```bash
curl -s https://copr.fedorainfracloud.org/coprs/supervillain/i2pd/repo/epel-9/supervillain-i2pd-epel-9.repo -o /etc/yum.repos.d/i2pd-epel-9.repo
curl -s https://copr.fedorainfracloud.org/coprs/supervillain/i2pd/repo/epel-10/supervillain-i2pd-epel-10.repo -o /etc/yum.repos.d/i2pd-epel-10.repo
dnf install -y epel-release
```

Expand All @@ -35,17 +32,17 @@ Then install `i2pd`:
dnf install -y i2pd
```

## (Optional) Configuring `i2pd`
## Configuring `i2pd` (optional)

With the packages installed, you can configure `i2pd` if desired. The author uses `vim` for this, but if you prefer `nano` or something else, go ahead and substitute that in:
With the packages installed, you can configure `i2pd` if required. The author uses `vim` for this, but if you prefer `nano` or something else, go ahead and substitute that in:

```bash
vim /etc/i2pd/i2pd.conf
```

The default `i2pd.conf` file is pretty descriptive, but can get long if you just want a basic configuration, you can leave as-is.

However, if you want to enable IPv6 and UPnP and listen the HTTP proxy to port `12345`, a configuration allowing this is as follows:
However, if you want to enable IPv6 and UPnP and set the listen HTTP proxy port to `12345`, a configuration allowing this follows:

```bash
ipv6 = true
Expand All @@ -55,7 +52,7 @@ port = 12345
enabled = true
```

If you wish to set other options, the configuration file is self-explanatory on all the possible options.
If you want to set other options, the configuration file is self-explanatory on all the possible options.

## Enabling `i2pd`

Expand All @@ -67,7 +64,7 @@ systemctl enable --now i2pd

## Visiting I2P eepsites

In this example, we are using Firefox on Rocky Linux. If you are not using Firefox, refer to the documentation of your application to set an HTTP proxy.
This example, uses Firefox on Rocky Linux. If you are not using Firefox, see the documentation of your application to set an HTTP proxy.

Open up Firefox, click the hamburger menu icon, and then go to **Settings**:

Expand All @@ -81,10 +78,10 @@ Then select **Manual proxy connection**, enter in `localhost` and `4444` (or the

![Firefox Connection Settings dialog](../images/i2p_proxy_ff_3.png)

Now, you are able to browse I2P eepsites. As an example, navigate to `http://planet.i2p` (Note: the `http://` is important to prevent Firefox from defaulting to a serch engine):
Now, you are able to browse I2P eepsites. As an example, navigate to `http://planet.i2p` (Note: the `http://` is important to prevent Firefox from defaulting to a search engine):

![Firefox viewing planet.i2p](../images/i2p_proxy_ff_4.png)

## Conclusion

With so many internet users concerned about online privacy, I2P is one way to access hidden websites securely. `i2pd` is lightweight software which makes browsing I2P websites possible, alongside sharing your connection as an relay.
With so many internet users concerned about online privacy, I2P is one way to access hidden websites securely. `i2pd` is lightweight software that makes browsing I2P websites possible, alongside sharing your connection as an relay.