i2pd/README.md

i2pd
====

i2p router for Linux written on C++

Requires gcc 4.6 and higher, boost 1.46 and higher, crypto++

on Windows

Requires msvs2013 (require Visual C++ Compiler November 2013 CTP update), boost 1.46 and higher, crypto++

Build Statuses
---------------

- Linux x64      - [![Build Status](https://jenkins.nordcloud.no/buildStatus/icon?job=i2pd-linux)](https://jenkins.nordcloud.no/job/i2pd-linux/)
- Linux ARM      - Too be added
- Mac OS X       - Too be added
- Microsoft VC13 - Too be added


Testing
-------

First, build it.

* $ cd i2pd
* $ make

Next, find out your public ip. (find it for example at http://www.whatismyip.com/)

Then, run it with:

$ ./i2p --host=YOUR_PUBLIC_IP

The client should now reseed by itself.

To visit an I2P page, you need to find the b32 address of your destination.
After that, go to the webconsole and add it behind the url. (Remove http:// and b32.i2p from the address)

This should resulting in for example:
http://localhost:7070/4oes3rlgrpbkmzv4lqcfili23h3cvpwslqcfjlk6vvguxyggspwa


Options
-------

* --host=               - The external IP
* --port=               - The port to listen on
* --httpport=           - The http port to listen on
* --log=                - Enable or disable logging to file. 1 for yes, 0 for no.
* --daemon=             - Enable or disable daemon mode. 1 for yes, 0 for no.
* --unreachable=        - 1 if router is declared as unreachable and works through introducers.
* --httpproxyport=      - The port to listen on (HTTP Proxy)
* --socksproxyport=     - The port to listen on (SOCKS Proxy)
* --ircport=      		- The local port of IRC tunnel to listen on. 6668 by default
* --ircdest=      		- I2P destination address of IRC server. For example irc.postman.i2p
* --eepkeys=      		- File name containing destination keys. For example privKeys.dat
* --eephost=      		- Address incoming trafic forward to. 127.0.0.1 by default
* --eepport=      		- Port incoming trafic forward to. 80 by default