Download I2P
Dependency
Java Runtime 1.5 or higher. (Oracle/Sun Java Version 6, OpenJDK 6, or IcedTea6 recommended)Determine your installed Java version here or type java -version at your command prompt.
Clean installs
- Graphical installer:
i2pinstall_0.8.12.exe (SHA256 7a05b96c535f565b06aeec3b83fca6245b1159003d4e2da2149374ba0f476847 sig)
Download that file and run it.
If you're not on windows you can typejava -jar i2pinstall_0.8.12.exein a terminal to run the installer. Mac users can avoid going to the terminal by renaming the downloaded file to end with.jarand then double-clicking the installer. On other platforms you may be able to right-click and select "Open with Java". - Command line (headless) install:
Download the graphical installer file above and runjava -jar i2pinstall_0.8.12.exe -consolefrom the command line. This will work on windows. linux, and mac (yes really). - Packages for Debian & Ubuntu
- Source install:
i2psource_0.8.12.tar.bz2 (SHA256 019d6018e7093650cf67fd883b0cf0f12aa2f4f0cddc5ef6a08e6147af07f142 sig)
Alternately, you can fetch the source from monotone.
Run(tar xjvf i2psource_0.8.12.tar.bz2 ; cd i2p-0.8.12 ; ant pkg)then either run the GUI installer or headless install as above
I2P can also be downloaded from our project pages on Launchpad and Google Code.
Post-install work
After running the installer on windows, simply click on the "Start I2P" button which will bring up the router console, which has further instructions.
On Unix-like systems, I2P can be started as a service using the "i2prouter" script, located in the directory you selected for I2P. Changing to that directory in a console and issuing "sh i2prouter status" should tell you the router's status. The arguments "start", "stop" and "restart" control the service. The router console can be accessed at its usual location. For users on OpenSolaris and other systems for which the wrapper (i2psvc) is not supported, start the router with "sh runplain.sh" instead.
When installing for the first time, please remember to adjust your NAT/firewall if you can, bearing in mind the Internet-facing ports I2P uses, described here among other ports. If you have successfully opened your port to inbound TCP, also enable inbound TCP on the configuration page.
Also, please review and adjust the bandwidth settings on the configuration page, as the default settings of 96 KBps down / 40 KBps up are fairly slow.
If you want to reach eepsites via your browser, have a look on the browser proxy setup page for an easy howto.
Updates from earlier releases:
Both automatic and manual upgrades are available for the release.
If you are running 0.7.5 or later, your router should detect the new release. To upgrade simply click the 'Download Update' button on your router console when it appears.
Due to a bug in release 0.7.6, those whose first I2P installation was that version and have not upgraded manually may get a "downloaded version is not greater than current version" error, and should use the manual update method below.
If you are running 0.7.4 or earlier, please see the 0.7.5 release notes for important information about how to configure your router to automatically receive the release.
If you are running 0.6.1.30 or earlier, please see instructions for important information about how to configure your router to automatically receive the release.
- If you have reconfigured your router following the instructions, you should see a link on your router console allowing you to download and install the new release by just clicking on that link.
- Alternately, you can use the manual method specified below.
Updates from earlier releases (manual method):
- Download i2pupdate_0.8.12.zip (SHA256 a9556998b136d47b124749f426d86514e7128094308f03085b889f34bbdf8dc0 sig) to your I2P installation directory and rename as i2pupdate.zip. (alternately, you can get the source as above and run "ant updater", then copy the resulting i2pupdate.zip to your I2P installation directory). You do NOT need to unzip that file.
- Click "Restart"
- Grab a cup of coffee and come back in 11 minutes














