diff --git a/apps/routerconsole/resources/docs/readme.html b/apps/routerconsole/resources/docs/readme.html index 5cb933425ef9f2fa1d50ffe39c4155cd60f0748b..276f2eccf1c42eaeb6361847957896f200134b79 100644 --- a/apps/routerconsole/resources/docs/readme.html +++ b/apps/routerconsole/resources/docs/readme.html @@ -2,70 +2,67 @@ <ul class="links"> -<li><b>Starting Up</b><br> -If you've just started I2P, the number of <i>Active Peers</i> indicated under the <i>Peers</i> section in the side panel on the left should start to grow over the next few minutes. -When your router is ready, you'll also see a <i>Local Tunnel</i> named <i>Shared Clients</i> listed there, and possibly other clients and servers. -If not, see the troubleshooting section <a href="#trouble">below</a>. -These <i>Local Tunnels</i> provide connections to the I2P network, enabling your bittorrent, email, web proxy and other services. -Your <a href="/netdb">Network Database</a> indicates all known peers on the network. -Additionally, you can monitor existing <a href="/peers">Peer Connections</a>, and view existing <a href="/tunnels">Tunnels</a> and their status. -More information is available on the <a href="/help">help page</a>.</li> - <li><b>Network Integration</b><br> -When you start I2P, it may take a few minutes to bootstrap (integrate) your router into the network and find additional peers, so please be patient. -When I2P starts up, and during normal operation, I2P's tunnel build readiness indicator in the side panel may indicate that I2P is "Rejecting Tunnels"; this is normal behavior. -Once green circles are indicated next to your <i>Local Tunnels</i>, there is a wide variety of things you can do with I2P, and below we introduce you to some of them.</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. + +Once the router has joined the network, a <i>Local </i> named <i>Shared Clients</i> will appear. If not, see the troubleshooting section [below](http://127.0.0.1:7657/console#trouble). Local Tunnels provide connections to the I2P network, enabling bittorrent, email, web proxy and other services. The [Network Database](http://127.0.0.1:7657/netdb) indicates all known peers on the network. Additionally, you can monitor existing [Peer Connections](http://127.0.0.1:7657/peers), and view existing [Tunnels](http://127.0.0.1:7657/tunnels) and their status. More information is available on the [help page](http://127.0.0.1:7657/help). Once green circles are indicated next to your Local Tunnels, you can access the I2P network. + </ul> -<h3>Services on I2P</h3> +<h3>Applications And Services</h3> <ul class="links"> -<li><b>Hidden Services and Public Web Browsing</b><br> -On I2P you can access hidden service websites ("I2P sites") and other services, and you can host your own services. -You can also access the normal web anonymously via I2P's built-in web proxy (outproxy). -<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>, then browse to an I2P Site or website at an <code>http://</code> or <code>https://</code> address. -If you wish to disable or change outproxy access to the non-anonymous internet, remove or modify the outproxy entry for <code>false.i2p</code> under the <i>Outproxies</i> option in the <a href="/i2ptunnel/edit?tunnel=0" target="_blank">I2P HTTP Proxy Tunnel Editor</a>. -In the "Sites of Interest" section <a href="#eepsites">below</a>, we list a few of the sites hosted on I2P.<br> -There are also a number of semi-official and unofficial efforts to build browsing tools for I2P, +<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>. -While these are all interesting projects, please evaluate them to see if they fit within your personal threat -model before trusting them with your well-being. +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>Anonymous Email</b><br> -Postman's I2P-based mail system can be accessed either via <a href="/webmail">I2P's built-in mail client</a> or with any external mail client. -Accounts can send and receive mail from the normal internet. +<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>Anonymous File Transfer</b><br> -<a href="/torrents">I2PSnark</a> is integrated into I2P, providing anonymous, encrypted BitTorrent transfers. +<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>Anonymous Chat</b><br> +<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 communcations are encrypted in transit by I2P to prevent interception. +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. -I2P is also suitable for unmonitorable and uncensorable anonymous chat, as well as alternative IRC servers, Jabber servers, website-based chat, and more. -You may run your own servers over I2P in whatever flavor you choose, or if you're a developer write your own <a href="http://i2p-projekt.i2p/applications.html" target="_blank">I2P applications</a>. + +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>Forums and Blogging</b><br> -All normal blogging, forum and CMS software will run over I2P, though you're 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 and locked-down! -Also, there are quite a few community run forums on I2P in various languages; see <a href="#eepsites">below</a> for some suggestions.</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> -Extend the usefulness of I2P by installing plugins: blogging, chatting, file sharing and other plugins have already been written or ported and await your <a href="http://wiki.i2p-projekt.i2p/wiki/index.php/Plugins" target="_blank">installation</a>! -Browse the plugins and related info at <a href="http://wiki.i2p-projekt.i2p/wiki/index.php/Plugins" target="_blank">wiki.i2p-projekt.i2p</a>. +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>Anonymous Encrypted Web Hosting on I2P</h3> +<h3>Self-Host An I2P Site</h3> <ul class="links"> @@ -78,32 +75,28 @@ You can also run any alternative web server platform over I2P and replace the bu 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-Hidden Services of Interest</h3> +<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 Community Forums</b><br> -<a href="http://zzz.i2p/" target="_blank">zzz's developer forums</a> hosts discussion related to I2P development. - -<a href="http://i2pforum.i2p/" target="_blank">i2pforum.i2p</a>: A forum where problems and ideas relating to I2P and associated topics are discussed.</li> +<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 I2P and publishes them all in one place. A good site to visit to see the community at work!</li> - -<li><b>I2P Network Health</b><br> -<a href="http://stats.i2p/cgi-bin/dashboard.cgi" target="_blank">stats.i2p</a>: Check out various aspects of network performance with this I2P network monitoring site run by zzz.</li> +<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> -<li><b>Discover I2P</b><br> -There are many more hidden services - just follow the links from the ones you see, bookmark your favourites, and visit them often!<br></li> </ul> @@ -111,9 +104,9 @@ There are many more hidden services - just follow the links from the ones you se <ul class="links"> -<li><b>Be Patient!</b><br> -I2P 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! +<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> @@ -165,11 +158,7 @@ For developer-related discussions, please visit <a href="http://zzz.i2p/" target 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> -I2P is developed and maintained mostly through unfunded, voluntary participation by community members. -We're happy to accept <a href="http://i2p-projekt.i2p/donate.html" target="_blank">donations</a>, which go into essential hosting and administrative costs. -We have <a href="http://i2p-projekt.i2p/bounties.html" target="_blank">cash bounties</a> for aspects of I2P for developers looking for incentives to participate, and we're always looking for more <a href="http://i2p-projekt.i2p/newdevelopers.html" target="_blank">Java coders</a>, <a href="http://i2p-projekt.i2p/newtranslators.html" target="_blank">translators</a>, promoters and users to help I2P grow. -The bigger the I2P network, the more everyone benefits, so simply telling all your friends about I2P (and lending a hand with the installation and setup where needed) is helpful. -For further info on how you can participate, visit the <a href="http://i2p-projekt.i2p/getinvolved.html" target="_blank">volunteers page</a> on the website.</li> +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>