i2p.www/i2p2www/pages/downloads/debian.html

{% extends "global/layout.html" %}
{% block title %}Debian/Ubuntu{% endblock %}
{% block content %}
<h1>{{ _('Debian I2P Packages') }}</h1>

{% trans -%}
The Debian packages
have been tested and <em>should </em>work on x86/x86_64 platforms running:
{%- endtrans %}
<ul>
  <li>{% trans %}<a href="#ubuntu">Ubuntu</a> (Precise <em>12.04</em> and newer){% endtrans %}</li>
  <li><a href="#ubuntu">Mint</a></li>
  <li>{% trans %}<a href="#debian">Debian Linux</a> (Squeeze and newer) &amp; kFreeBSD{% endtrans %}</li>
  <li><a href="#debian">Knoppix</a></li>
</ul>

{% trans trac='http://trac.i2p2.de/newticket?component=package/debian&owner=killyourtv&cc=killyourtv@mail.i2p' -%}
The I2P packages <em>may</em> work on systems not listed above. Please report any issues
with these packages on <a href="{{ trac }}">Trac</a> at
<a href="{{ trac }}">https://trac.i2p2.de</a>.
{%- endtrans %}
<ul>
  <li>{% trans %}Option 1: <a href="#ubuntu">Recent versions</a> of Ubuntu and its derivatives (<em>Try this if you're not using Debian)</em>{% endtrans %}</li>
  <li>{% trans %}Option 2: <a href="#debian">Debian</a> (including Debian-derivatives){% endtrans %}</li>
</ul>

<h2 id="ubuntu">{{ _('Instructions for Ubuntu 12.04 Precise Pangolin (and newer) and derivatives like Linux Mint &amp; Trisquel') }}</h2>
<h5>{{ _('Adding the PPA via the command line and installing I2P') }}</h5>
<ol>
  <li>
    {% trans %}Open a terminal and enter:{% endtrans %}<br />
    <code>&nbsp;&nbsp;&nbsp; sudo apt-add-repository ppa:i2p-maintainers/i2p</code><br />
{% trans -%}
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.
{%- endtrans %}
  </li>
  <li>
    {% trans %}Notify your package manager of the new PPA by entering:{% endtrans %}<br />
    <code>&nbsp;&nbsp;&nbsp; sudo apt-get update</code><br />
{% trans -%}
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.
{%- endtrans %}
  </li>
  <li>{% trans %}You are now ready to install I2P!{% endtrans %}<br />
    <code>&nbsp;&nbsp;&nbsp;&nbsp;sudo apt-get install i2p</code></li>
</ol>

<h5>{{ _('Adding the PPA Using Synaptic') }}</h5>
<ol>
  <li>
    {% trans -%}
    Open Synaptic (System -&gt; Administration -&gt; Synaptic Package Manager).
    {%- endtrans %}
  </li>
  <li>
    {% trans -%}
    Once Synaptic opens, select <em>Repositories</em> from the <em>Settings</em> menu.
    {%- endtrans %}
  </li>
  <li>
    {% trans -%}
    Click the <em>Other Sources</em> tab and click <em>Add</em>. Paste <code>ppa:i2p-maintainers/i2p</code> into the APT-line field and click <em>Add Source</em>. Click the <em>Close</em> button then <em>Reload</em>.
    {%- endtrans %}
  </li>
  <li>
    {% trans -%}
    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 <em>Mark for Installation</em>. After doing so you may see a <em>Mark additional required changes?</em> popup. If so, click <em>Mark</em> then <em>Apply</em>.
    {%- endtrans %}
  </li>
</ol>

{% trans -%}
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.
{%- endtrans %}

<h2 id="debian">{{ _('Instructions for Debian') }}</h2>

<em>Currently supported architectures include amd64, i386, armel, armhf (for Raspbian), kfreebsd-amd64, kfreebsd-i386, and powerpc.</em>

<p>{% trans -%}
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").
{%- endtrans %}</p>
<ol>
  <li>{% trans file='/etc/apt/sources.list.d/i2p.list' -%}
Add lines like the following to <code>{{ file }}</code>.{% endtrans %}<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>{% trans repokey=url_for('static', filename='debian-repo.pub') -%}
Download <a href="{{ repokey }}">the  key used to sign the repository</a> and add it to apt:
{%- endtrans %}<br />
&nbsp;&nbsp;&nbsp; <code>apt-key add debian-repo.pub</code>
  </li>

  <li>
    {% trans %}Notify your package manager of the new repository by entering{% endtrans %}<br />
    <code>&nbsp;&nbsp;&nbsp; apt-get update</code><br />
{% trans -%}
This command will retrieve the latest list of software from every
repository enabled on your system, including the I2P repository added in step
1.
{%- endtrans %}
  </li>
  <li>{% trans -%}
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.
{%- endtrans %}<br />
    <code>&nbsp;&nbsp;&nbsp; apt-get install i2p i2p-keyring</code></li>
</ol>

{% trans -%}
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.
{%- endtrans %}

<h2 id="Post-install_work">{{ _('Post-install work') }}</h2>

{% trans -%}
Using these I2P packages the I2P router can be started in the following
three ways:
{%- endtrans %}
<ul>
  <li>
    {% trans -%}
    &quot;on demand&quot; using the i2prouter script. Simply run &quot;<code>i2prouter
start</code>&quot; from a command prompt. (Note: Do <strong><u>not</u></strong> use
sudo or run it as root!)
    {%- endtrans %}
  </li>
  <li>
    {% trans -%}
    &quot;on demand&quot; 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 <strong><u>not</u></strong>
use sudo or run it as root!)
    {%- endtrans %}
  </li>
  <li>
    {% trans -%}
    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.
    {%- endtrans %}
  </li>
</ul>

<p>{% trans -%}
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 find <a href="http://portforward.com">portforward.com</a> to be helpful.
{%- endtrans %}</p>

<p>{% trans -%}
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.
{%- endtrans %}</p>

<p>{% trans browserconfig=site_url('about/browser-config') -%}
If you want to reach eepsites via your browser, have a look on the <a href="{{ browserconfig }}">browser proxy setup</a> page for an easy howto.
{%- endtrans %}</p>

{% endblock %}