i2p-zero/README.md

Embedded I2P Java Router with SAM interface

This project will run under Linux, and build native launchers for Linux, MacOS and Windows. The launchers will include the I2P router, a SAM listener and a minimal JVM.

Building the launchers

First, retrieve this project from git:

git clone https://github.com/knaccc/embedded-i2p-java-router-with-sam.git

Note that the current version of this script uses jdk-11.0.2. If this version of Java becomes no longer available for download, then update the references to jdk-11.0.2 in this folder structure to the later version. To locate a recent JDK download URL, see https://jdk.java.net/11/

Also note that JDKs for Linux, MacOS and Windows will be downloaded, which will total several hundred megabytes.

Run the bin/build-all.sh script, which will in turn call the following scripts:

1. bin/import-packages.sh to retrieve the I2P Java sources, OpenJDK and the Ant build tool

2. bin/build-original-i2p.sh to build the I2P project retrieved from the I2P repository

3. build-launcher.sh to convert the I2P JARs to modules, compile the Java source code in this project, and then use the jlink tool to build a zero-dependency platform-specific launchers.

Running the launchers

To run the Linux router, type:

dist/linux/router/bin/launch.sh

To run the MacOS router, type:

dist/mac/router/bin/launch.sh

For Windows, run:

dist/windows/router/bin/launch.bat

If it launches successfully, you'll see the message:

I2P router launched. SAM listening on port 7656.
Press Ctrl-C to gracefully shut down the router (or send the SIGINT signal to the process).

Check that the I2P router is running and that it is listening for SAM connections

fuser 7656/tcp