i2pplus

Installing I2P+

This document covers installation, running, and system services for end users. Developers building I2P+ from source should see BUILD.md.

Installing

Headless (console mode)

java -jar i2pinstall.exe -console
# or
java -jar i2pinstall.jar -console

GUI installer

java -jar i2pinstall.exe
# or
java -jar i2pinstall.jar

On Windows, double-click i2pinstall.exe.

Updating an existing installation

Move i2pupdate.zip into the existing installation directory and restart.

Running I2P

# Linux, BSD, Mac
sh i2prouter start

# Windows
I2P.exe
# or
i2prouter.bat

# Platforms without wrapper support
sh runplain.sh

Installing as a system service (Linux)

I2P+ supports native systemd service management, falling back to init.d where systemd is not available.

1. Configure the run-as user

Edit the i2prouter script and set RUNASUSER to the unprivileged user that should own the I2P process:

RUNASUSER=i2p

2. Install the service

Must be run as root:

sudo sh i2prouter install

This registers the service and enables it at boot. On systemd systems, a unit file is created automatically.

3. Manage the service

Action	Command
Start	sudo sh i2prouter start
Stop gracefully	sudo sh i2prouter graceful
Stop immediately	sudo sh i2prouter stop
Status	sudo sh i2prouter status
Uninstall	sudo sh i2prouter remove

On systemd systems you can also use:

sudo systemctl start i2p
sudo systemctl stop i2p
sudo systemctl status i2p
sudo systemctl enable i2p
sudo systemctl disable i2p

Windows service management

Action	Command
Install as service	service.ps1 -Action Install
Uninstall service	service.ps1 -Action Uninstall

Uninstalling

rm -rf $I2PInstallDir ~/.i2p