Debian I2P Packages
Debian Sid, Ubuntu Bionic 18.04
I2P is available in the official repositories for Ubuntu Bionic 18.04 and Debian Sid. Install the "i2p" package using your package manager, as you would any other package. The instructions below are not required.Debian Stretch and older, Ubuntu Artful 17.10 and older
The Debian packages have been tested and should work on x86/x86_64 platforms running:- Ubuntu (Precise 12.04 and newer)
- Mint
- Debian Linux (Wheezy and newer)
- Knoppix
- Option 1: Recent versions of Ubuntu and its derivatives (Try this if you're not using Debian)
- Option 2: Debian (including Debian-derivatives)
Instructions for Ubuntu and derivatives like Linux Mint & Trisquel
Adding the PPA via the command line and installing I2P
-
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. -
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. - You are now ready to install I2P!
sudo apt-get install i2p
Adding the PPA Using Synaptic
- Open Synaptic (System -> Administration -> Synaptic Package Manager).
- Once Synaptic opens, select Repositories from the Settings menu.
-
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. -
In the Quick Filter box, type in
i2p
and press enter. Wheni2p
is returned in the results list, right clicki2p
and select Mark for Installation. After doing so you may see a Mark additional required changes? popup. If so, click Mark then Apply.
Instructions for Debian
Currently supported architectures include amd64, i386, armel, armhf (for Raspbian).Note: The steps below should be performed with root access (i.e., switching
user to root with su
or by prefixing each command with sudo
).
- Ensure that
apt-transport-https
andcurl
are installed.sudo apt-get update sudo apt-get install apt-transport-https curl
-
Check which version of Debian you are using on this page at the Debian wiki
and verify with
/etc/debian_version
on your system. Then, add lines like the following to/etc/apt/sources.list.d/i2p.list
.
For Stretch (stable):
deb https://deb.i2p2.de/ stretch main deb-src https://deb.i2p2.de/ stretch main
For Jessie (old-stable):
deb https://deb.i2p2.de/ jessie main deb-src https://deb.i2p2.de/ jessie main
For Wheezy (obsolete):
deb https://deb.i2p2.de/ wheezy main deb-src https://deb.i2p2.de/ wheezy main
Note: If you are running Debian Sid (testing), then you can install I2P directly from Debian's main repository:sudo apt-get install i2p
- Download the key used to sign the repository:
curl -o i2p-debian-repo.key.asc https://geti2p.net/_static/i2p-debian-repo.key.asc
-
Check the fingerprint and owner of the key without importing anything:
gpg -n --import --import-options import-show i2p-debian-repo.key.asc
-
Add the key to APT's keyring:
sudo apt-key add i2p-debian-repo.key.asc
-
Notify your package manager of the new repository by entering
sudo apt-get update
- You are now ready to install I2P! Installing the
i2p-keyring
package will ensure that you receive updates to the repository's GPG key.
sudo apt-get install i2p i2p-keyring
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 find 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.