|
|
MuWire is available as a plugin to the Java I2P router. Building the plugin is disabled by default because it is more complicated than building the desktop application.
|
|
|
|
|
|
Follow these steps:
|
|
|
|
|
|
I. Build I2P
|
|
|
1. Clone the I2P source code from [I2P Github]
|
|
|
2. Build the source with `ant clean pkg`
|
|
|
3. Create a directory under the MuWire source tree called `i2pjars` and copy all .jar files generated by the previous step there. You will find them in `pkg-temp/lib`
|
|
|
|
|
|
II. Generate plugin signing key
|
|
|
|
|
|
The plugin must be signed for the router to load it, and the signing certificate must be deployed:
|
|
|
1. Generate a certificate by invoking the following command from the root of the MuWire source tree:
|
|
|
```
|
|
|
java -cp i2pjars/i2p.jar net.i2p.crypto.SU3File keygen <fileName.crt> keystore.ks <your@mail.com>
|
|
|
```
|
|
|
The generator will ask you for a password for the newly generated certificate, and it will be stored in fileName.crt.
|
|
|
|
|
|
2. Copy the `keystore.ks` file generated in the previous step to `$HOME/.i2p-plugin-keys/plugin-su3-keystore.ks`.
|
|
|
|
|
|
3. Rename the certificate file the following way - if you gave `your@mail.com` as email address in step 1 above, the certificate file should be called `your_at_mail.com.crt`.
|
|
|
|
|
|
4. Copy the renamed certificate file to the installation of I2P, inside the `certificates/plugin` directory.
|
|
|
|
|
|
|
|
|
III. Build the plugin
|
|
|
|
|
|
Now you're ready to build the plugin.
|
|
|
|
|
|
1. Un-comment the `webui` and `plug` sub-projects in the `settings.gradle` file.
|
|
|
2. Edit `gradle.properties` to change the signer to the email address you generated the certificate for.
|
|
|
3. Run `./gradlew -PbuildNumber=<some integer> assemble` where "some integer" will be the minor build number.
|
|
|
4. Just before it finishes, the build script will ask you for the password to unlock the certificate
|
|
|
5. If all goes well, the plugin will be in `plug/build/MuWire.su3`
|
|
|
|
|
|
IV. Install the plugin
|
|
|
|
|
|
1. Start the I2P router
|
|
|
2. Go to the plugin installation page, that is usually http://127.0.0.1:7657/configplugins
|
|
|
3. In the "Installation From File" section select the MuWire.su3 generated by the build system
|
|
|
4. Click "Install Plugin From File"
|
|
|
5. MuWire should appear on the right side of the console. It is also reachable via http://127.0.0.1:7657/MuWire
|
|
|
|
|
|
|
|
|
[I2P Github]: https://github.com/i2p/i2p.i2p |
|
|
\ No newline at end of file |