113 lines
6.7 KiB
HTML
113 lines
6.7 KiB
HTML
{% extends "_layout.html" %}
|
|
{% block title %}Debian/Ubuntu{% endblock %}
|
|
{% block content %}
|
|
<h1>Debian I2P Packages</h1>
|
|
|
|
The Debian packages have been tested and <span style="font-style: italic;">should </span>work on x86/x86_64 platforms running
|
|
<ul>
|
|
<li><a href="debian#ubuntu">Ubuntu</a> (Precise <span style="font-style: italic;">12.04</span> and newer)</li><li><a href="debian.html#ubuntu">Mint</a></li>
|
|
<li><a href="debian#debian">Debian Linux</a> (Squeeze and newer) & kFreeBSD</li>
|
|
<li><a href="debian#debian">Knoppix</a></li>
|
|
</ul>
|
|
The I2P packages <span style="font-style: italic;">may</span> work on systems not listed above. Please report any issues with these packages on <a href="http://trac.i2p2.no/newticket?component=package/debian&owner=killyourtv&cc=killyourtv@mail.i2p">Trac</a> at <a href="http://trac.i2p2.no/newticket?component=package/debian&owner=killyourtv&cc=killyourtv@mail.i2p">https://trac.i2p2.de</a>.
|
|
<ul>
|
|
<li>Option 1: <a href="debian#ubuntu">Recent versions</a> of Ubuntu and its derivatives (<span style="font-style: italic;">Try this if you're not using Debian)</span></li>
|
|
<li>Option 2: <a href="debian#debian">Debian</a> (including Debian-derivatives)</li>
|
|
</ul>
|
|
<h2 id="ubuntu">Instructions for Ubuntu Precise Pangolin (and newer) and derivatives like Linux Mint & Trisquel</h2>
|
|
<h5>Adding the PPA via the command line and installing I2P</h5>
|
|
<ol>
|
|
<li>Open a terminal and enter: <br />
|
|
<code> sudo apt-add-repository ppa:i2p-maintainers/i2p</code><br />
|
|
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.</li>
|
|
<li>Notify your package manager of the new PPA by entering<br />
|
|
<code> sudo apt-get update</code><br />
|
|
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.</li>
|
|
<li>You are now ready to install I2P! <br />
|
|
<code> sudo apt-get install i2p</code></li>
|
|
</ol>
|
|
<h5>Adding the PPA Using Synaptic</h5>
|
|
<ol>
|
|
<li>Open Synaptic (System -> Administration -> Synaptic Package Manager).</li>
|
|
<li>Once Synaptic opens, select <span style="font-style: italic;">Repositories</span> from the <span style="font-style: italic;">Settings</span> menu.</li>
|
|
<li>Click the <span style="font-style: italic;">Other Sources</span> tab and click <span style="font-style: italic;">Add</span>. Paste <code>ppa:i2p-maintainers/i2p</code> into the APT-line field and click <span style="font-style: italic;">Add Source</span>. Click the <span style="font-style: italic;">Close</span> button then <span style="font-style: italic;">Reload</span>.</li>
|
|
<li>In the Quick Filter box, type in <code>i2p</code> and press enter. When <code>i2p</code> is returned in the results list, right click <code>i2p</code> and select <span style="font-style: italic;">Mark for Installation</span>. After doing so you may see a <span style="font-style: italic;">Mark additional required changes?</span> popup. If so, click <span style="font-style: italic;">Mark</span> then <span style="font-style: italic;">Apply</span>.</li>
|
|
</ol>
|
|
|
|
After the installation process completes you can move on to the next
|
|
part of <a href="debian#Post-install_work">starting I2P</a> and configuring it for your system.
|
|
|
|
<h2 id="debian">Instructions for Debian</h2>
|
|
<i>Currently supported architectures include amd64, i386, armel, armhf (for Raspbian), kfreebsd-amd64, kfreebsd-i386, and powerpc.</i>
|
|
<p>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").
|
|
</p>
|
|
<ol>
|
|
<li>Add lines like the following to <code>/etc/apt/sources.list.d/i2p.list</code>.<br>
|
|
For Squeeze:<br>
|
|
<pre>
|
|
<code>deb http://deb.i2p2.no/ squeeze main
|
|
deb-src http://deb.i2p2.no/ squeeze main</code>
|
|
</pre>
|
|
<br />
|
|
For Wheezy (stable):<br />
|
|
<pre>
|
|
<code>deb http://deb.i2p2.no/ stable main
|
|
deb-src http://deb.i2p2.no/ stable main</code>
|
|
</pre>
|
|
<br />
|
|
For Testing or Unstable:<br />
|
|
<pre>
|
|
<code>deb http://deb.i2p2.no/ unstable main
|
|
deb-src http://deb.i2p2.no/ unstable main</code>
|
|
</pre>
|
|
</li>
|
|
<li>Download <a href="/_static/debian-repo.pub">the key used to sign the repository</a> and add it to apt:<br />
|
|
<code>apt-key add debian-repo.pub</code>
|
|
</li>
|
|
|
|
<li>Notify your package manager of the new repository by entering<br />
|
|
<code> apt-get update</code><br />
|
|
This command will retrieve the latest list of software from every
|
|
repository enabled on your system, including the I2P repository added in step
|
|
1.</li>
|
|
<li>You are now ready to install I2P! Installing the <code>i2p-keyring</code>
|
|
package will ensure that you receive updates to the repository's
|
|
GPG key.<br />
|
|
<code> apt-get install i2p i2p-keyring</code></li>
|
|
</ol>
|
|
|
|
After the installation process completes you can move on to the next part of <a href="#Post-install_work">starting I2P</a> and configuring it for your system.
|
|
<h2 id="Post-install_work">Post-install work</h2>
|
|
Using these I2P packages the I2P router can be started in the following
|
|
three ways:
|
|
<ul>
|
|
<li>"on demand" using the i2prouter script. Simply run "<code>i2prouter
|
|
start</code>" from a command prompt. (Note: Do <span style="font-weight: bold; text-decoration: underline;">not</span> use
|
|
sudo or run it as root!)</li>
|
|
<li>"on demand" without the <a href="http://wrapper.tanukisoftware.com/">java service wrapper</a>
|
|
(needed on non-Linux/non-x86 systems) by running "<code>i2prouter-nowrapper</code>".
|
|
(Note: Do <span style="font-weight: bold; text-decoration: underline;">not</span>
|
|
use sudo or run it as root!)</li>
|
|
<li>as a service that automatically runs when your system boots, even
|
|
before logging in. The service can be enabled with "<code>dpkg-reconfigure
|
|
i2p</code>" as root or using sudo. This is the recommended means of operation.</li>
|
|
</ul>
|
|
<p>When installing for the first time, please remember to <b>adjust
|
|
your NAT/firewall</b>
|
|
if you can. The ports to forward can be found on the <a href="http://127.0.0.1:7657/confignet">
|
|
network configuration page</a> in the router console. If guidance with respect to forwarding ports is needed,
|
|
you may <a href="http://www.portforward.com">portforward.com</a> to be helpful.
|
|
</p>
|
|
<p>Please review and <b>adjust the bandwidth settings</b> on the
|
|
<a href="http://127.0.0.1:7657/config.jsp">configuration page</a>,
|
|
as the default settings of 96 KB/s down / 40 KB/s up are fairly conservative.
|
|
</p>
|
|
<p>
|
|
If you want to reach eepsites via your browser, have a look on the <a href="htproxyports.html">browser proxy setup</a> page for an easy howto.</p>
|
|
{% endblock %}
|