i2p Setup and Use - shermand100/PiNodeXMR GitHub Wiki

i2p Setup

From v4.x.x of PiNode-XMR i2p will be available as an optional anonymity network. Please do your research for if you think this tool is suitable for usage and needs. The i2p package is not installed by default, you must select it manually. For this reason the new "I2P Interface" button in the Web UI navigation bar will not function until you have completed the following steps:

*Note PiNode-XMR uses the full i2p package (not just i2p-zero). This gives you full functionality and control.


Install i2p

1. Proceed to the Setup menu found in the Web Terminal, and select "Extra Network Tools"

i2p install found in extra network tools

Follow through the prompts:

  • When asked to set a username "pinodexmr" (without quotes) should be used.

i2p username

  • Memory is fine at default 128
  • Set to run at boot
  • Optional - AppArmour can be turned on
  • Start i2p now

You will receive confirmation that the i2p interface is now active. This can be found at the navigation bar of the main PiNode-XMR Web Interface as "I2p Interface"


Configure i2p

2. Select "I2P Interface" from the navigation bar.

This will either bring you to the I2P Homepage or Welcome page. It is good practice on first run to go through the "Welcome" setup and configure country and bandwidth settings.

To do this go to http://pinodexmr.local:7657/welcome

i2p welcome page

And follow through it's basic setup.


Monero server and tunnel settings

3. Completing the previous step will bring you to the i2p homepage.

i2p Home

From here select "Hidden Services Manager" found in the centre of the screen

Under the header of "I2P Hidden Services" we will select a new "Standard" hidden service, and click create.

standard hidden service

Which will bring us to the configuration of this service. Two values should be entered.

  • Service Name (Under "Name" heading).
  • Port (Under "Target" heading).

name and port setting

The at the bottom of the page select "Save".

This will bring you back to the "Hidden Services Manager". You new Hidden Service will be shown with it's unique .b32 address.

Click "Start" on the right-hand edge to start this new service. Service running status is shown by a traffic light system of red, orange and green.

Hidden Service

Next we create a SOCKS5 tunnel for our outbound traffic.

Further down the "Hidden Services Manger" page, you'll find "I2P Client Tunnels".

Select from the "New Client Tunnel" dropdown menu "SOCKS 4/4a/5" and click "Create"

SOCKS tunnel create1

Again we are directed to the configuration page for this tunnel and two entries are required:

  • Tunnel Name (Under "Name" heading).
  • Port (Under "Access Point" heading).

SOCKS tunnel create2

Once these are entered, at the bottom of the page click "Save".

This again will bring you to the "Hidden Services Manager" page. Check your new Client Tunnel was created and select it to "Start".

This tunnel may show it's status as orange until traffic is flowing through it (by starting Monero next)


Configure PiNode-XMR to use these new services

4. Open a new browser tab for your PiNode-XMR Web UI and proceed to the i2p "Anonymity Networks" section of the "Node Control" tab.

Here we will enter the settings from our i2p setup. Copy/paste these into the relevant boxes, then click outside of the box to save them. You will receive confirmation that the setting is saved via notification. The text box showing the current value will take a page refresh to change (this will be fixed soon).

i2p web ui

Seed peers are required for i2p operation. One seed peer can be nominated, which if online will share it's peer list with your node. These nodes were found on 08.08.2020 and may help you get started.

  • ayodzcnzkjue56vtxxrypdwd3yrupa2z4sjvwgnqwh5ucvoqxteq.b32.i2p:18080
  • ayodzcnzkjue56vtxxrypdwd3yrupa2z4sjvwgnqwh5ucvoqxteq.b32.i2p:18083
  • jfcjk25fhvm6f2c77hxexla4g7dzzsj2a5fcw4kd75eitugdepra.b32.i2p:18080
  • moneroti7lckp4hjrqckoq5cfi2apuyxia42sp5x7tkbzjfwqfiq.b32.i2p:18080
  • nqussuztpeyrbtxz7j6fc32lugwm4ajincm5emqueihlbxq2rtza.b32.i2p:38080
  • snbrpdeug2vuojer6ql6ozcbdzddxbdbi3yiv7avchwnzzocrlaq.b32.i2p:18080
  • snbrpdeug2vuojer6ql6ozcbdzddxbdbi3yiv7avchwnzzocrlaq.b32.i2p:28082

Alternatively Monero World lists some seed nodes https://moneroworld.com/


Start your node

Once these settings have been entered you are free to select to start the node and it can be monitored using the same status pages as a normal node, I2P connections will begin to appear alongside IPv4 in the connected nodes section. If after ~20mins you don't have i2p connections, try another seed node.

i2p working


Further info

The i2p interface has a huge amount of functionality and information available. To check connections to your services the "I2P Tunnel Summary" is a good page. It will confirm your working service and tunnel with connections.

tunnel summary