I2P+

I2P+ Installation Guide

This comprehensive guide will help you install and configure I2P+ on your system.

Before You Begin

Important: If you installed I2P via the Easy Installer bundle you will need to uninstall it and remove or rename your %appdata%\i2p folder before installing I2P+. You may also need to manually download and install a Java JDK or JRE — Microsoft's latest build recommended.

Installation Methods

Method 1: Universal Installer

Download the universal I2P+ Java I2P installer compatible with Windows, Linux, BSD, and macOS.

Installation Steps:

1. Download the installer from the downloads section
2. Run the Java GUI installer by typing from a command prompt: java -jar ./i2pinstall.exe
3. For headless installation (no GUI): java -jar ./i2pinstall.exe -console
4. Install to the default directory location for your operating system
5. Start I2P+ using the appropriate method for your system

If you see Exception in thread "main" java.awt.AWTError: Assistive Technology not found: org.GNOME. when attempting to install, try running: sudo sed -i -e '/^assistive_technologies=/s/^/#/' /etc/java-*-openjdk/accessibility.properties

Method 2: Update Existing Installation

If you're running a manually installed version of I2P from the Java installer (not a repo or .deb installed version), updating is simple:

1. Download the i2pupdate.zip file
2. Copy the zip file to your I2P application folder
3. Restart the router

Note: Do not extract the zip file, simply copy it to the I2P application folder and restart I2P... I2P will extract the zip automatically and update.

Default Installation Locations

The default location of the (non-repo installed) I2P application folder varies by operating system:

• Windows: Program Files\i2p\ or Program Files (x86)\i2p\
• Apple: /Applications/i2p/
• Linux: ~/i2p/

Linux Repository Installation

If you have installed I2P from a software repository, you will need to disable the I2P service and download the I2P+ Linux Java installer:

1. Download the universal I2P+ Java I2P installer
2. Run the Java GUI installer: java -jar ./i2pinstall.exe
3. Install to the default directory: $HOME/i2p
4. Check for existing $HOME/.i2p directory and change ownership: sudo chown -R yourusername:yourusername ~/.i2p/
5. Stop and disable the repo I2P service: sudo service i2p stop && sudo systemctl disable i2p
6. Start the manually installed version: ~/i2p/i2prouter start
7. Verify I2P+ is running at http://127.0.0.1:7657

Startup Options:

• Add /bin/su yourusername -c "/home/yourusername/i2p/i2prouter start" to /etc/rc.local
• Add ~/i2p/i2prouter start to your session startup configuration
• Run ~/i2p/i2prouter install (uncomment #RUN_AS_USER= in ~/i2p/i2prouter and add your username)

HTTPS Configuration

As of 0.9.46+, the full installation will enable https:// access to the console by default; you will need to allow the (self-signed) certificate before you can access the router console.

To disable automatic redirection from http:// on :7657 to https:// on :7667, add this line to your router.config file:

Settings Folder Locations

Location of I2P settings folder (for non-repo installed I2P):

• Windows: %APPDATA%\I2P\
• Apple OS X: /Users/username/Library/Application Support/i2p
• Linux/*BSD: ~/.i2p/

Troubleshooting

Windows Service Issues

Note: On Windows, the Windows service to control I2P will be installed, for which you will require administrative privileges. The service control shortcuts may need to be run as an administrator to work.

Headless Installation

When installing I2P+ headlessly via the -console argument, the installer will default to installing to the current working directory. Create the desired installation directory first (usually ~/i2p/) and move the install.jar file into that directory before starting, or manually specify the installation path when prompted.