rss logo

How to Install and Configure I2P on Windows 11

I2P logo

I2P (Invisible Internet Project) is an open-source project designed to provide a secure and anonymous communication layer over the Internet. It helps protect user privacy and resist censorship by encrypting traffic and routing it through a decentralized network of I2P routers.

This anonymous network layer supports several services, including web browsing, P2P file sharing, and BitTorrent.

In this guide, you will learn how to install and configure I2P on Windows 11, including the initial setup, network configuration, port forwarding, Windows Firewall rules, and Firefox proxy settings.

Install I2P on Windows 11

Before installing I2P on Windows 11, make sure that Mozilla Firefox and a compatible Java Runtime Environment (JRE) are installed on your system. The procedure below uses Eclipse Temurin from Adoptium.

Install Java

I2P requires a compatible Java Runtime Environment (JRE) to run. Although the I2P project also provides an all-in-one Windows bundle that includes Java, this guide uses the standard installer and installs Java separately beforehand.

Rather than using Oracle Java, I recommend Eclipse Temurin from Adoptium (https://adoptium.net/). It is free, open source, and maintained by the Eclipse Adoptium project under the Eclipse Foundation.

  • Visit the official Adoptium website at https://adoptium.net/ and download Eclipse Temurin for Windows x64:
Adoptium download page showing Eclipse Temurin 21 for Windows x64 with the download button highlighted
Download Eclipse Temurin 21 for Windows x64 from the official Adoptium website.
  • Run the Eclipse Temurin JDK installer and click Next to start the setup:
Eclipse Temurin JDK 21 setup wizard welcome screen on Windows with the Next button highlighted
Eclipse Temurin JDK 21 setup wizard on Windows.
  • Accept the license agreement, then click Next:
Eclipse Temurin JDK setup license agreement with the acceptance checkbox selected and the Next button highlighted
Accept the Eclipse Temurin JDK license agreement to continue the installation.
  • Select Install for all users of this machine, then click Next:
Eclipse Temurin JDK installation scope screen with Install for all users of this machine selected and the Next button highlighted
Select the option to install Eclipse Temurin JDK for all users of the Windows machine.
  • Keep the default installation options, then click Next:
Eclipse Temurin JDK custom setup screen showing the default installation options and the Next button highlighted
Keep the default Eclipse Temurin JDK installation options and continue with the setup.
  • Click Install to begin the installation of Eclipse Temurin JDK:
Eclipse Temurin JDK ready to install screen with the Install button highlighted
Start the Eclipse Temurin JDK installation by clicking the Install button.
  • When the installation is complete, click Finish to close the setup wizard:
Eclipse Temurin JDK setup wizard showing the completed installation screen with the Finish button highlighted
Eclipse Temurin JDK installation completed successfully on Windows.

Install I2P

Official I2P download page showing the Windows download section with the Download Now button highlighted
Download the I2P Windows installer from the official I2P website.
  • Run the downloaded I2P installer. If Windows Defender SmartScreen displays a warning, click More info, then Run anyway:
Windows Defender SmartScreen warning for the I2P installer showing the More info link first, then the Run anyway button
If SmartScreen blocks the I2P installer, click More info and then Run anyway to continue.
  • Select your preferred language, then click OK to continue the installation:
I2P installer language selection window with English selected and the OK button highlighted
Select the installation language before starting the I2P setup wizard.
  • On the welcome screen, click Next to continue the installation:
I2P installer welcome screen showing version 2.8.2 with the Next button highlighted
Welcome screen of the I2P installer on Windows.
  • Read the information note if you wish, then click Next to continue the installation:
I2P installer information screen showing the public domain software note and the Next button highlighted
I2P installer information screen displayed before continuing the setup.
  • Select the installation path, confirm the directory creation if prompted, then click Next:
I2P installer directory selection screen showing the installation path, the directory creation confirmation dialog, and the OK and Next buttons highlighted
Select the I2P installation folder, confirm the directory creation, and continue the setup.
  • Select the Windows Service option so that I2P can start automatically in the background, then click Next:
I2P installer component selection screen with the Windows Service option selected and the Next button highlighted
Select the Windows Service option to have I2P start automatically in the background.
  • Once the installation process is complete, click Next to continue:
I2P installer progress screen showing completed pack installation and overall installation progress with the Next button highlighted
I2P installation progress screen showing that the installation has completed successfully.
  • Keep the default shortcut options, then click Next to continue:
I2P installer shortcut setup screen with Start Menu and desktop shortcut options selected and the Next button highlighted
Shortcut configuration screen of the I2P installer on Windows.
  • Click Done to close the installer and complete the I2P setup:
I2P installer final screen showing that the installation completed successfully with the Done button highlighted
Final screen of the I2P installer confirming that the installation completed successfully.

Post-Installation Configuration

After installing I2P, a few additional settings are required to ensure proper network connectivity. In this section, we will configure the I2P service, network ports, port forwarding, and Windows Firewall rules.

Service Check

  • Open the Windows Services console to verify that the I2P Service is running:
Windows Run dialog showing services.msc and the Services console with I2P Service highlighted and running
Use the Windows Services console to confirm that the I2P Service is installed, running, and set to start automatically.
  • Alternatively, use PowerShell:
PS C:\> Get-Service -Name I2P

Status   Name               DisplayName
------   ----               -----------
Running  I2P                I2P Service
  • If the service is not running, start it with:
PS C:\> Start-Service -Name I2P

Initial Configuration

  • Open the I2P Router Console from the desktop shortcut, or enter http://127.0.0.1:7657 in Firefox:
I2P Router Console shortcut icon on the Windows desktop
Launch the I2P Router Console from the Windows desktop shortcut or by opening the local web interface in Firefox.
  • Follow the setup wizard, select your preferred language, then click Next:
I2P setup wizard language selection screen with English selected and the Next button highlighted
Select the preferred language in the I2P setup wizard before continuing to the next step.
  • Select your preferred theme, then click Next to continue:
I2P setup wizard theme selection screen showing dark and light theme options with the Next button highlighted
Select the preferred theme in the I2P setup wizard before continuing to the next step.
  • Run the bandwidth test, then click Next to continue:
I2P setup wizard bandwidth test screen explaining the test with Next, Skip Setup, and Skip Bandwidth Test options visible
Introduction screen of the I2P bandwidth test in the setup wizard.
  • Wait for the bandwidth test to complete, then click Next to continue:
I2P setup wizard bandwidth test screen showing that the test is complete and the Next button is highlighted
Bandwidth test screen in the I2P setup wizard once the test has completed and the installation can continue.
  • Review the bandwidth configuration, adjust the values if needed, then click Next to continue:
I2P setup wizard bandwidth configuration screen showing inbound and outbound bandwidth values, sharing percentage, and the Next button highlighted
Review and adjust the I2P bandwidth configuration before continuing to the next step.
  • We will configure Firefox manually later in this guide. For now, click Next to continue:
I2P setup wizard Browser and Application Setup screen with Firefox configuration information and the Next button highlighted
I2P browser and application setup screen with information about configuring Firefox and other I2P applications.
  • Once the setup wizard is complete, click Finished to open the I2P Router Console:
I2P setup wizard final welcome screen with the Finished button highlighted
Final screen of the I2P setup wizard before opening the I2P Router Console.
  • Once the setup is complete, the main I2P Router Console dashboard should appear:
I2P Router Console main dashboard showing network status, bandwidth information, applications, community links, and configuration sections
Main dashboard of the I2P Router Console after the initial setup on Windows 11.

Port Configuration

In this section, we will identify or configure the UDP and TCP ports used by I2P. These values will be needed later to configure port forwarding and the Windows Firewall rules correctly.

  • Go to Configuration > Settings > Network, or open http://127.0.0.1:7657/confignet. Note the UDP port and the TCP port used by your I2P router (for example, 22648):
I2P network configuration screen showing the UDP port 22648, the TCP port set to use the same value, and the Save changes button highlighted
Identify the UDP and TCP ports used by I2P before configuring port forwarding and Windows Firewall rules.
  • Once your UDP and TCP ports have been identified (or modified), you should configure your Internet Gateway to perform NAT and forward these ports to the internal IP address of the workstation running your I2P router. For example, here I forward UDP and TCP port 22648 to the IP address 192.168.1.10:
I2P port forwarding diagram showing TCP and UDP port 22648 forwarded by an Internet router to a Windows 11 workstation at 192.168.1.10
I2P port forwarding configuration with TCP and UDP port 22648 forwarded from the Internet router to the Windows 11 workstation at 192.168.1.10.

Windows Firewall Configuration

The next step is to allow the required inbound traffic through Windows Firewall so that the I2P router can accept incoming connections.

  • Create inbound firewall rules for the following:
    • The UDP port configured earlier (22648 in this example)
    • The TCP port configured earlier (22648 in this example)
    • The java.exe executable used by I2P

You can create these firewall rules either through the Windows Firewall graphical interface or with PowerShell. Both methods are shown below.

  • Open Windows Defender Firewall with Advanced Security, select Inbound Rules, then click New Rule...:
Windows Defender Firewall with Advanced Security showing Inbound Rules selected and the New Rule option highlighted
Create a new inbound firewall rule from Windows Defender Firewall with Advanced Security.
  • In the New Inbound Rule Wizard, select Custom as the rule type, then click Next:
New Inbound Rule Wizard in Windows Defender Firewall with the Custom rule type selected and the Next button highlighted
Select the Custom rule type in the New Inbound Rule Wizard before continuing to the next step.

💡 Note: You can also select All programs instead of specifying the Java executable. This option is slightly more permissive, but it will also work.

  • Select This program path, then click Browse... to locate the java.exe executable used by your Java installation:
Windows Defender Firewall inbound rule wizard showing This program path selected with the java.exe path entered for Eclipse Temurin
Specify the path to the java.exe executable used by the Java runtime running I2P.
  • For the TCP rule, select the TCP protocol, then enter the local port number used by I2P:
Windows Defender Firewall inbound rule wizard showing the TCP protocol selected with local port 22648 specified
Create the inbound TCP firewall rule by selecting the TCP protocol and entering the I2P port number.
  • For the UDP rule, select the UDP protocol, then enter the local port number used by I2P:
Windows Defender Firewall inbound rule wizard showing the UDP protocol selected with local port 22648 specified
Create the inbound UDP firewall rule by selecting the UDP protocol and entering the I2P port number.

Configure Windows Firewall (PowerShell)

  • Open PowerShell with administrative privileges and run the following commands:

💡 Note: The Eclipse Adoptium installation path may vary depending on the version installed. Adjust the path to java.exe according to your own configuration.

PS C:\> New-NetFirewallRule -DisplayName "I2P_UDP" -Direction Inbound -Protocol UDP -LocalPort 22648 -Action Allow
PS C:\> New-NetFirewallRule -DisplayName "I2P_TCP" -Direction Inbound -Protocol TCP -LocalPort 22648 -Action Allow
PS C:\> New-NetFirewallRule -DisplayName "JAVA" -Direction Inbound -Program "%ProgramFiles%\Eclipse Adoptium\jdk-21.0.7.6-hotspot\bin\java.exe" -Action Allow

Check Network Connectivity

Once the configuration is complete, verify that your I2P router can properly connect to the I2P network.

  • From the I2P Router Console, click the restart button to restart the router:
I2P Router Console main dashboard with the restart router button highlighted
Restart the I2P router from the Router Console so the network status can be checked after the configuration changes.
  • After a few minutes, once the I2P router has restarted and connected to peers, the network status should display OK:
I2P Router Console sidebar showing Network OK status, uptime, bandwidth usage, and local tunnel information
The I2P Router Console shows Network: OK once the router is properly connected to the I2P network.

Configure Firefox

Now we will configure Firefox to access websites and services through the I2P network.

Firefox Profile (Optional)

It's not required, but I recommend creating a new Firefox profile. This will allow you to easily switch between your regular configuration and the I2P network.

  • Open the Firefox Profile Manager by pressing Win + R, entering firefox --ProfileManager, and clicking OK:
Windows Run dialog showing the command firefox --ProfileManager used to open Firefox Profile Manager
Use the Windows Run dialog to open Firefox Profile Manager.
  • Click Create Profile… to start the Firefox profile creation wizard:
Firefox Choose User Profile window with the Create Profile button highlighted
Open the Firefox profile creation wizard from the Firefox Profile Manager.
  • In the Welcome screen of the Create Profile Wizard, click Next to continue:
Firefox Create Profile Wizard welcome screen with the Next button highlighted
Welcome screen of the Firefox Create Profile Wizard before creating a new profile.
  • Enter a name for the new Firefox profile, then click Finish:
Firefox Create Profile Wizard showing I2P entered as the new profile name with the Finish button highlighted
Enter a name for the new Firefox profile and click Finish to create it.
  • Select the newly created Firefox profile, then click Start Firefox to launch the browser:
Firefox Choose User Profile window with the I2P profile selected and the Start Firefox button highlighted
Select the I2P Firefox profile and start Firefox with this dedicated profile.

Configure Firefox Proxy

  • Open the Firefox menu(1), click Settings(2), search for proxy(3), then click Settings...(4) in the Network Settings section:
Firefox settings page showing the menu, Settings option, proxy search field, and Network Settings button used to open proxy configuration
Open the Firefox proxy settings from the Settings page by searching for proxy and selecting Network Settings.
  • Configure the Connection Settings as shown below, then click OK:
Firefox Connection Settings window showing Manual proxy configuration selected, HTTP proxy set to 127.0.0.1 on port 4444, Also use this proxy for HTTPS enabled, and the OK button highlighted
Configure Firefox to use the local I2P proxy, then save the settings by clicking OK.

💡 Note: Because I2P is designed to provide anonymous and privacy-focused communication, the network may be relatively slow, especially shortly after the router starts. Connecting to peers and building tunnels can take several minutes. It is therefore recommended to wait about 10 to 20 minutes before expecting normal network performance.

  • Once the proxy settings have been configured, you can check the public IP address seen by websites using an IP address checker. In this example, I use ShebangTheIP 😇) together with an external IP checking website:
Firefox displaying a public IP address check on mon-ip.com with IPv4 and IPv6 addresses also shown by a browser extension
Check the public IP addresses reported by Firefox after configuring the browser proxy settings.

💡 Tip: Now that your I2P router is configured and connected to the network, you can also use BitTorrent over I2P for anonymous peer-to-peer file sharing. See my guide: Share files with BitTorrent over I2P.