forked from I2P_Developers/i2p.i2p
<div lang="en">
<ul class="links">
<li><b>Network Integration</b><br>
<li>If you have just installed and started an I2P router, the number of <i>Active Peers</i> indicated under the <i>Peers</i> section in the side panel on the left will increase over the next few minutes. When an I2P router starts up, and during its regular operation, the tunnel build readiness indicator in the side panel may indicate that it is "Rejecting Tunnels." This is a normal behaviour. </li>
<li>Once the router has joined the network, a <i>Local </i> named <i>Shared Clients</i> will appear. If not, see the troubleshooting section <a href="http://127.0.0.1:7657/console#trouble">below</a>. Local Tunnels provide connections to the I2P network, enabling bittorrent, email, web proxy and other services. The <a href="http://127.0.0.1:7657/netdb">Network Database</a> indicates all known peers on the network. Additionally, you can monitor existing <a href="http://127.0.0.1:7657/peers">Peer Connections</a>, and view existing <a href="http://127.0.0.1:7657/tunnels">Tunnels</a> and their status. More information is available on the <a href="http://127.0.0.1:7657/help">help page</a>. Once green circles are indicated next to your Local Tunnels, you can access the I2P network.</li>
</ul>
<h3>Applications And Services</h3>
<ul class="links">
<li><b>I2P Browsing Functions</b><br>
A properly configured browser is needed for accessing content on the I2P network (I2P sites and services) and accessing clearnet content using the outproxy service specified in the Hidden Services Manager of the I2P router.
<a href="https://geti2p.net/en/about/browser-config" target="_blank">Configure your browser</a> to use the HTTP proxy at <code>127.0.0.1 port 4444</code>.
If you wish to disable or change outproxy access, remove or modify the outproxy entry for <code>exit.stormycloud.i2p</code> in the <i>Outproxies</i> option in the <a href="/i2ptunnel/edit?tunnel=0" target="_blank">I2P HTTP Proxy Tunnel Editor</a>.<br>
There are semi-official and unofficial efforts to build browsing tools for I2P,
including a <a href="https://geti2p.net/en/download/firefox">preconfigured Firefox Browser profile</a>,
<a href="http://idk.i2p/I2P-in-Private-Browsing-Mode-Firefox">an easy-to-install WebExtension</a>,
or via <a href="https://www.whonix.org/wiki/I2P">automatic launchers in privacy-focused Linux distributions like Whonix</a>.
The easiest way to check if I2P network access is functioning properly is to visit /home of the I2P router console and click on the I2P website link in the Community section.
If an I2P site address is not in your router address book, you will be prompted to use a jump service and given the option in the process.
</li>
<li><b>Email</b><br>
Postman's I2P-based mail (SusiMail) service can be accessed either via <a href="/webmail">I2P's built-in mail client</a> or with any external mail client.
It is primarily intended for use with Postman’s email servers inside of the I2P network. It is designed to avoid leaking information about email use to other networks. SusiMail is bridged so it can send and receive email from the internet as well. Occasionally you may see some services like Gmail classifying it as spam, which you can correct in your Internet email service providers settings.
For an account, visit <a href="http://hq.postman.i2p/" target="_blank">hq.postman.i2p</a>.
</li>
<li><b>I2PSnark BitTorrent Client</b><br>
<a href="/torrents">I2PSnark</a> Snark is an I2P network only BitTorrent client. It never makes a connection to a peer over any other network.
</li>
<li><b>IRC/Chat</b><br>
Start your IRC client (e.g. HexChat) and connect to the <a href="irc://127.0.0.1:6668/i2p">server</a> at <code>127.0.0.1 port 6668</code>.
You do not need to configure a proxy in your IRC client; I2P provides you with a local IRC tunnel (configured in your IRC client as an IRC server or remote host).
Your local I2P IRC tunnel on <code>localhost:6668</code> will direct you to one of three IRC servers hosted on I2P by Postman, echelon and zl0, but neither you nor they know where the other is, and your communications are encrypted in transit by I2P to prevent interception.
Once you're there, <code>#i2p-chat</code> and <code>#i2p-dev</code> are just a few of the available channels you may wish to join.
You may run your own servers over I2P, such an other IRC servers, Jabber servers, website-based chat and more. If you are a developer, you can create your own <a href="http://i2p-projekt.i2p/applications.html" target="_blank">I2P applications</a>.
Both UDP and TCP protocols are <a href="http://i2p-projekt.i2p/techintro.html#op.transport" target="_blank">supported</a>.</li>
<li><b>The AddressBook</b><br>
This is a locally-defined list of human-readable addresses (ie: i2p-projekt.i2p) and corresponding I2P addresses.(udhdrtrcetjm5sxzskjyr5ztpeszydbh4dpl3pl4utgqqw2v4jna.b32.i2p) It integrates with other applications to allow you to use those human-readable addresses in place of those I2P addresses. It is more similar to a hosts file or a contact list than a network database or a DNS service. There is no recognized global namespace, you decide what any given .i2p domain maps too in the end.</li>
<li><b>The QR Code Generator</b><br>
Besides the Address Book, I2P addresses can be shared by converting them into QR codes and scanning them with a camera. This is especially useful for Android devices.</li>
<li><b>I2P Hidden Services Manager</b><br>
This is a general-purpose adapter for forwarding services ( ie SSH ) into I2P and proxying client requests to and from I2P. It provides a variety of “Tunnel Types” which are able to do advance filtering of traffic before it reaches I2P.</li>
<li><a name="plugins"></a><b>Plugins for I2P</b><br>
Browse plugins and related information at <a href="http://wiki.i2p-projekt.i2p/wiki/index.php/Plugins" target="_blank">wiki.i2p-projekt.i2p</a>.
If you're a <a href="http://wiki.i2p-projekt.i2p/wiki/index.php/Plugins" target="_blank">developer</a>, a complete framework for writing your own plugins is provided with <a href="http://i2p-projekt.i2p/plugins.html" target="_blank">documentation</a>.</li>
</ul>
<h3>Self-Host An I2P Site</h3>
<ul class="links">
<li><b>Built-in Web-Server</b><br>
I2P comes with a built-in web server for hosting your own hidden service website ("eepsite") on the I2P network: a <a href="https://www.eclipse.org/jetty/" target="_blank">Jetty</a> instance listening on <a href="http://127.0.0.1:7658/" target="_blank">http://127.0.0.1:7658/</a>.
To host your own content, simply place your files in the <code>eepsite/docroot/</code> directory (or place any standard JSP/Servlet .war files under <code>eepsite/webapps</code>, or standard CGI scripts under <code>eepsite/cgi-bin</code>) and they'll show up.
You can also run any alternative web server platform over I2P and replace the built-in server, or run it on another tunnel.</li>
<li><b>Start Your Tunnel</b><br>
After starting up, your pre-configured <a href="/i2ptunnel/" target="_blank">I2P Webserver Tunnel</a>, your website will be visible (but not discoverable) to others.
Detailed instructions for starting your website, registering an .i2p domain and promoting your site to others are accessible via your own I2P webserver on <a href="http://127.0.0.1:7658/help/" target="_blank">http://127.0.0.1:7658/help/</a>.</li>
<li><b>Forums and Blogging</b><br>
Most blogging, forum and CMS software are compatible with the I2P network, It is advised to take extra precautions with security when setting up and to keep all associated software (e.g. Php, MySql, Python, Apache) up to date.</li>
</ul>
<a name="eepsites"></a>
<h3>I2P Community Resources</h3>
<ul class="links twocol">
<li><b>Invisible Internet Project (I2P) Official Website</b><br>
<a href="http://i2p-projekt.i2p" target="_blank">i2p-projekt.i2p</a>: Secure and anonymous connections to <a href="https://geti2p.net/en/" target="_blank">geti2p.net</a>. If you want to know more about how I2P works or how you can participate, this is the first place to visit!</li>
<li><b>I2P Forum</b><br><a href="http://i2pforum.i2p/" target="_blank">i2pforum.i2p</a>: A forum where I2P topics are discussed.</li>
<li><b>I2P Planet</b><br>
<a href="http://planet.i2p/" target="_blank">planet.i2p</a>: An RSS aggregator site that takes news and events from around the I2P network and publishes them all in one place. A good site to visit to see the community at work.</li>
<li><b>I2P Bug Tracker - GitLab</b><br>
<a href="http://git.idk.i2p/" target="_blank">git.idk.i2p</a>: I2P's issue reporting and bug-tracking system. Please visit if you have an issue to report, also available at <a href="https://i2pgit.org/" target="_blank">https://i2pgit.org/</a></li>
</ul>
<h2 id="trouble">Troubleshooting and Further Assistance</h2>
<ul class="links">
<li><b>Network Integration</b><br>
Your I2P router may be slow to integrate into network the first time you run it as it bootstraps into the network and finds peers.
The longer your I2P router is running, the better it will perform, so try and keep your router on as long as you can, 24/7 if possible.
If, after 30 minutes, your <i>Active: [connected/recent]</i> count still has less than 10 peers, or your total number of <i>Integrated</i> peers is less than 5, there are several things you can do to check for problems:</li>
<li><b>Check Your Configuration and Bandwidth Allocation</b><br>
I2P functions best when you can accurately reflect the speed of your network connection in the <a href="/config">bandwidth configuration section</a>.
By default I2P is configured with some fairly conservative values that will not suit many use cases, so please take time to review these settings and correct where necessary.
The more bandwidth you allocate, <i>specifically</i> upstream bandwidth, the more you will benefit from the network.</li>
<li><b>Firewalls, Modems and Routers</b><br>
Where possible, please ensure I2P/Java is allowed un-firewalled access from the internet by configuring your modem/router/pc firewall accordingly.
If you're behind a prohibitive firewall but have unrestricted outbound access, I2P can still function; you can turn off inbound access and rely on <a href="http://i2p-projekt.i2p/udp.html" target="_blank">SSU IP Address Detection</a> (<a href="https://en.wikipedia.org/wiki/Hole_punching_(networking)" target="_blank">firewall hole punching</a>) to connect you to the network, and your network status in the side panel will indicate "Network: Firewalled".
For optimal performance, please ensure I2P's <a href="/confignet">external port</a> is visible from the internet.
See below for more information.</li>
<li><b>Check Your Proxy Settings</b><br>
If you cannot see any websites at all (not even <a href="http://i2p-projekt.i2p/" target="_blank">i2p-projekt.i2p</a>), make sure your browser's proxy is set to access http traffic (<i>not</i> https, <i>not</i> socks) via <code>127.0.0.1 port 4444</code>.
If you need some help, there's <a href="https://geti2p.net/en/about/browser-config" target="_blank">a guide</a> to configuring your browser for I2P use.</li>
<li><b>Check Your Logs</b><br>
<a href="/logs">Logs</a> may be helpful to resolve a problem.
You may wish to paste excerpts in our <a href="http://i2pforum.i2p/" target="_blank">forum</a> for help, or perhaps <a href="http://paste.idk.i2p/" target="_blank">paste</a> it instead and reference the link on IRC for help.</li>
<li><b>Verify Java is Up to Date</b><br>
Ensure your Java is up to date.
Check your Java version at the top of <a href="/logs">the logs page</a>.
<li><b>Problems running on Legacy Hardware</b><br>
[Linux/BSD] If you can't start the router with <code>i2p/i2prouter start</code> try the <code>runplain.sh</code> script in the same directory.
Root privileges are never required to run I2P.
<li><b>Enable Universal Plug and Play (UPnP)</b><br>
Your modem or router probably supports UPnP for automatic port forwarding.
Ensure UPnP support is enabled on your modem or router.
Now try restarting the <a href="/">I2P router</a>.
If successful, I2P should report "Network: OK" in the side panel once the I2P router completes initial connectivity tests.</li>
<li><b>Port Forwarding</b><br>
Open <a href="/confignet">I2P's port</a> on your modem, router and/or firewall(s) for better connectivity (ideally both UDP and TCP).
More information on how to go about port forwarding can be easily found through a web search.
Should you have any difficulties, you may request assistance in our forums and IRC channels listed below.
Note that I2P does not support connecting to the internet via an http or socks proxy [patches welcome!], though you can connect to proxies via I2P itself once connected to the network.</li>
<li><b>Getting Support Online</b><br>
You may also want to review the information on the <a href="http://i2p-projekt.i2p/" target="_blank">I2P website</a>, post messages to the <a href="http://i2pforum.i2p/" target="_blank">I2P discussion forum</a> or swing by <a href="irc://127.0.0.1:6668/i2p">#i2p</a> or <a href="irc://127.0.0.1:6668/i2p-chat">#i2p-chat</a> on I2P's internal IRC network - Irc2P.
These channels are also available outside of I2P's encrypted, anonymous network via <a href="irc://irc.freenode.net/i2p">Freenode IRC</a>.</li>
<li><b>Reporting Bugs</b><br>
To report a bug, please file a ticket on <a href="http://git.idk.i2p/" target="_blank">git.idk.i2p</a> or, over clearnet, <a href="https://i2pgit.org/" target="_blank">https://i2pgit.org/</a>.
For developer-related discussions, please visit <a href="http://zzz.i2p/" target="_blank">zzz's developer forums</a> or come and visit the <a href="irc://127.0.0.1:6668/i2p-dev">developer channel</a> on I2P's IRC network.
Developers can browse source at <a href="http://git.idk.i2p/i2p-hackers/i2p.i2p" target="_blank">git.idk.i2p</a>.
<li><b>Get Involved!</b><br>
For information about how you can help the network or participate in I2P core development, visit the <a href="http://i2p-projekt.i2p/getinvolved.html" target="_blank">volunteers page</a> on the website.</li>
</ul>
<div class="topness"><a href="#top">[Return to Top]</a></div>
</div>