Debian I2P Packages

The packages hosted on the I2P Launchpad site have been tested and should work on x86/x86_64 platforms running

• Ubuntu (Precise 12.04 and newer)
• Mint
• Debian Linux (Wheezy and newer) & kFreeBSD
• Knoppix

The I2P packages may work on systems not listed above. Please report any issues with these packages on Trac at http://trac.i2p2.de.

• Option 1: Recent versions of Ubuntu and its derivatives (Try this if you're not using Debian)
• Option 2: Debian (including Debian-derivatives)
• Option 3: Non-Linux (and possibly Non-x86 architectures)

Instructions for Ubuntu Precise Pangolin (and newer) and derivatives like Linux Mint & Trisquel

Adding the PPA via the command line and installing I2P

1. Open a terminal and enter:
       sudo apt-add-repository ppa:i2p-maintainers/i2p
   This command will add the PPA to /etc/apt/sources.list.d and fetch the gpg key that the repository has been signed with. The GPG key ensures that the packages have not been tampered with since being built.
2. Notify your package manager of the new PPA by entering
       sudo apt-get update
   This command will retrieve the latest list of software from each repository that is enabled on your system, including the I2P PPA that was added with the earlier command.
3. You are now ready to install I2P!
       sudo apt-get install i2p

Adding the PPA Using Synaptic

1. Open Synaptic (System -> Administration -> Synaptic Package Manager).
2. Once Synaptic opens, select Repositories from the Settings menu.
3. Click the Other Sources tab and click Add. Paste ppa:i2p-maintainers/i2p into the APT-line field and click Add Source. Click the Close button then Reload.
4. In the Quick Filter box, type in i2p and press enter. When i2p is returned in the results list, right click i2p and select Mark for Installation. After doing so you may see a Mark additional required changes? popup. If so, click Mark then Apply.

After the installation process completes you can move on to the next part of starting I2P and configuring it for your system.

Instructions for Debian Wheezy and newer

(For Squeeze you can follow the instructions here).

The steps below should be performed with root access (i.e., switching user to root with "su" or by prefixing each command with "sudo").

1. Add the GPG key that signs the repository with the following command:
       apt-key adv --keyserver keyserver.ubuntu.com --recv-keys EB2CC88B
   You'll have output like the following if the command was successful:
       
2. Add the following entries to /etc/apt/sources.list.d/i2p.list
    deb http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu raring main
    deb-src http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu raring main
   
3. Notify your package manager of the new PPA by entering
       apt-get update
   This command will retrieve the latest list of software from every repository enabled on your system, including the I2P PPA added in step 1.
4. You are now ready to install I2P!
       apt-get install i2p

After the installation process completes you can move on to the next part of starting I2P and configuring it for your system.

Instructions for Non-Linux / Non-x86

The steps below should be performed with root access (i.e., switching user to root with "su" or by prefixing each command with "sudo").

1. Download the i2p-router package from the PPA. Alternatively, there are unofficial packages available within I2P (or through an inproxy (not anonyous!)) for armel, armhf, and kfreebsd.
2. Make sure that you have Java installed. Running apt-get install default-jre should be sufficient.
   You are now ready to install I2P!
       dpkg -i i2p-router_*.deb
3. It is recommended to compile jbigi for your system to achieve better performance. Instructions are available here.

After the installation process completes you can move on to the next part of starting I2P and configuring it for your system.

Post-install work

Using these I2P packages the I2P router can be started in the following three ways:

• "on demand" using the i2prouter script. Simply run "i2prouter start" from a command prompt. (Note: Do not use sudo or run it as root!)
• "on demand" without the java service wrapper (needed on non-Linux/non-x86 systems) by running "i2prouter-nowrapper". (Note: Do not use sudo or run it as root!)
• as a service that automatically runs when your system boots, even before logging in. The service can be enabled with "dpkg-reconfigure i2p" as root or using sudo. This is the recommended means of operation.

When installing for the first time, please remember to adjust your NAT/firewall if you can. The ports to forward can be found on the network configuration page in the router console. If guidance with respect to forwarding ports is needed, you may portforward.com to be helpful.

Please review and adjust the bandwidth settings on the configuration page, as the default settings of 96 KB/s down / 40 KB/s up are fairly conservative.

If you want to reach eepsites via your browser, have a look on the browser proxy setup page for an easy howto.