i2pplus

Java CI I2P+ Installer I2P+ Update zip I2P+ I2PSnark standalone I2P+ Javadocs Docker AppImage

I2P+

This is the source code for the soft-fork of the Java implementation of I2P.

Latest release: https://i2pplus.github.io/

Installing

See INSTALL.md or https://i2pplus.github.io/ for installation instructions.

Windows installer note

With Java > 1.8 or alternative distributions (AdoptOpenJDK, etc.), the installer exe may fail with “Java not found” or “invalid/corrupt” errors. Workaround: extract install.jar from the exe and run java -jar install.jar from the command line.

Documentation

https://geti2p.net/how

FAQ: https://geti2p.net/faq

API: https://i2pplus.github.io/javadoc/ or run ‘ant javadoc’ then start at build/javadoc/index.html

How to contribute / Hack on I2P+

Please check out HACKING.md and other documents in the docs directory.

Building packages from source

To get development branch from source control: https://github.com/I2PPlus/i2pplus

Prerequisites

Ant build process

On x86 systems run the following (this will build using IzPack4):

ant pkg

On non-x86, use one of the following instead:

ant installer-linux
ant installer-freebsd
ant installer-osx
ant installer-windows

If you want to build with IzPack5, download from: http://izpack.org/downloads/ and then install it, and then run the following command(s):

ant installer5-linux
ant installer5-freebsd
ant installer5-osx
ant installer5-windows

To build an unsigned update for an existing installation, run:

ant updater

or with Gradle:

./gradlew updater

If you have issues building a full installer (Java14 and later may generate build errors for izpack relating to pack200), you can build a full installation zip which can be extracted and run in situ:

 ant zip-linux
 ant zip-freebsd
 ant zip-macos
 ant zip-windows

Run ‘ant’ with no arguments to see other build options.

To build an AppImage for Linux:

ant buildAppImage

See tools/appimage/README.md for details.

To build a self-contained Debian package for Debian/Ubuntu without external Jetty/Tomcat dependencies:

ant buildDeb

This creates a self-contained .deb package that includes bundled Jetty and Tomcat libraries. Requires only OpenJDK runtime (installed automatically via package manager).

To run in Docker, see docker/README.md

Contact info

Need help? Visit the IRC channel #saltR on the I2P IRC network

Bug reports: https://github.com/I2PPlus/i2pplus/issues

Licenses

I2P+ is licensed under the AGPL v.3.

For the various sub-component licenses, see: README.md

See also

Documentation

Sub-projects

MISC