77 lines
2.8 KiB
Plaintext
77 lines
2.8 KiB
Plaintext
This is a simple standalone application that talks to the
|
|
"i2pcontrol" jsonrpc interface on I2P routers.
|
|
|
|
Current setup:
|
|
* Build itoopie:
|
|
Dependencies: ant, Java SDK
|
|
'ant' in the i2p.itoopie directory
|
|
* Run:
|
|
Dependencies: Java runtime and an I2P router that supports the jsonrpc interface
|
|
java -jar dist/itoopie.jar
|
|
|
|
The router jsonrpc interface is configured by default for https at localhost:7650.
|
|
7650 is the default port for i2pd and the old Java router console "i2pcontrol" plugin.
|
|
|
|
For i2pd, the jsonrpc interface is off by default.
|
|
You must set i2pcontrol.enabled=true in i2pd.conf.
|
|
See https://i2pd.readthedocs.io/en/latest/user-guide/configuration/#i2pcontrol-interface
|
|
for more information and other options.
|
|
|
|
The Java router console now bundles the jsonrpc interface by default
|
|
as a webapp on port 7657, and the i2pcontrol plugin is no longer necessary.
|
|
You may disable or remove the plugin at http://localhost:7657/configplugins
|
|
The jsonrpc webapp is off by default.
|
|
To start it, go to http://localhost:7657/configwebapps and start the
|
|
"jsonrpc" webapp. To always run it, click the "Run at Startup" setting
|
|
and click "Save WebApp Configuration".
|
|
You MUST change itoopie's "I2P Node port" to 7657 to connect to the jsonrpc webapp.
|
|
itoopie will automatically use http for port 7657.
|
|
If the console is on another port, it is assumed to be HTTPS, and you
|
|
must add "server.target=jsonrpc/" to the config file ~/.itoopie/itoopie.conf
|
|
|
|
|
|
Version 1 API specification:
|
|
http://i2p-projekt.i2p/en/docs/api/i2pcontrol
|
|
https://geti2p.net/en/docs/api/i2pcontrol
|
|
|
|
Version 2 API proposal (abandoned):
|
|
http://i2p-projekt.i2p/spec/proposals/118-i2pcontrol-api-2
|
|
https://geti2p.net/spec/proposals/118-i2pcontrol-api-2
|
|
|
|
|
|
Pre-built binaries:
|
|
http://stats.i2p/i2p/plugins/others/
|
|
Source: i2p.itoopie branch in git: https://github.com/i2p/i2p.itoopie
|
|
java -jar itoopie-install.exe to install on non-Windows.
|
|
|
|
|
|
Server source:
|
|
Plugin (obsolete) https://github.com/i2p/i2p.plugins.i2pcontrol
|
|
Console bundled webapp: https://github.com/i2p/i2p.i2p/tree/master/apps/i2pcontrol
|
|
i2pd: https://github.com/PurpleI2P/i2pd/tree/openssl/daemon
|
|
|
|
|
|
Command line test client:
|
|
scripts/i2pcontrol.py in the server source
|
|
|
|
|
|
Discussion forum:
|
|
http://zzz.i2p/forums/16
|
|
|
|
Bugs:
|
|
Report on above forum, or http://trac.i2p2.i2p/ or https://trac.i2p2.de/
|
|
|
|
|
|
License: Apache 2
|
|
|
|
itoopie and I2PControl were sponsored by Relakks & Ipredator.
|
|
Development began during the summer of 2011 and the first alpha was launched in July.
|
|
|
|
Thanks to:
|
|
- Jan-Erik Fiske and Peter Sunde for actively helping privacy and anonymity online.
|
|
- KillYourTV for debugging and helping out with platform testing
|
|
as well as fixing the shortcuts of the installer.
|
|
- User for tons of testing and a lot of good ideas and requests.
|
|
- ReturningNovice for testing and finding bugs.
|
|
- zzz for helping out with broad knowledge of I2P, build process and Jetty.
|