I2P+

Русский | 日本語 | 中文 | हिन्दी | བོད་ཡིག | فارسی | العربية | Español | Français | Deutsch | Türkçe | Bahasa Indonesia | Українська | Português | Polski | 한국어 | Tiếng Việt | ภาษาไทย | اردو | עברית | Italiano | Nederlands | Română | Čeština | Magyar | Ελληνικά

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

• Java SDK 1.8.0 or higher
• Apache Ant 1.9.8 or higher
• The xgettext, msgfmt, and msgmerge tools installed from the GNU gettext package via your package manager or http://www.gnu.org/software/gettext/
• Build environment must use a UTF-8 locale.
• For Debian package builds: dpkg-deb and fakeroot packages (via your package manager)

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

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

• docs/README.md - Full documentation index
• docs/INSTALL.md - Installation guide
• docs/INSTALL-headless.md - Headless (console mode) installation
• docs/HACKING.md - Developer guide and build systems
• docs/DIRECTORIES.md - Source tree layout and where to find things
• docs/LICENSE.md - Third-party licenses
• docs/history.txt - Full changelog

Sub-projects

• apps/README.md - Application overview
• apps/addressbook/README.md - Addressbook application
• apps/desktopgui/README.md - Desktop GUI application
• apps/i2pcontrol/README.md - I2P Control API
• apps/i2psnark/README.md - I2PSnark BitTorrent client
• apps/i2ptunnel/README.md - I2P Tunnel application
• apps/imagegen/README.md - Image generation tools
• apps/jetty/README.md - Jetty HTTP server
• apps/jrobin/README.md - JRobin monitoring library
• apps/ministreaming/README.md - Minimal streaming library
• apps/pack200/README.md - Pack200 compression
• apps/proxyscript/README.md - Proxy scripts
• apps/routerconsole/README.md - Router console
• apps/sam/README.md - Simple Anonymous Messaging
• apps/streaming/README.md - Streaming library
• apps/susidns/README.md - DNS server
• apps/susimail/README.md - I2P email client
• apps/systray/README.md - System tray application
• core/README.md - Core library documentation
• installer/lib/jbigi/README.md - Native JNI library for cryptography (GMP)

MISC

• docs/i2p-sessionban-nftables.md - Managing I2P session bans with nftables
• installer/resources/README.md - Bundled installer resources
• tools/scripts/README.md - Utility scripts for development and administration
• tools/scripts/tests/README.md - Validation and testing scripts