forked from I2P_Developers/i2p.www
205 lines
9.1 KiB
HTML
205 lines
9.1 KiB
HTML
{% extends "global/layout.html" %}
|
|
{% block title %}Debian/Ubuntu{% endblock %}
|
|
{% block content %}
|
|
<h1>{{ _('Debian I2P Packages') }}</h1>
|
|
|
|
{% trans -%}
|
|
The packages hosted on <a href="https://launchpad.net/%7Ei2p-maintainers/+archive/i2p">the I2P Launchpad site</a>
|
|
have been tested and <em>should </em>work on x86/x86_64 platforms running:
|
|
{%- endtrans %}
|
|
<ul>
|
|
<li>{% trans %}<a href="#ubuntu">Ubuntu</a> (Hardy <em>8.04</em> and newer){% endtrans %}</li>
|
|
<li><a href="#ubuntu">Mint</a> <em>11</em></li>
|
|
<li>{% trans %}<a href="#debian">Debian Linux</a> (Lenny and newer) & <a href="#nonlinux">kFreeBSD</a> (Wheezy){% endtrans %}</li>
|
|
<li><a href="#debian">Knoppix</a></li>
|
|
<li><a href="#debian">Simply MEPIS</a> <em>8.5.03-rel1</em></li>
|
|
<li><a href="#ubuntu">Trisque</a>l <em>4.5.1</em></li>
|
|
<li><a href="#debian">gNewSense</a> <em>2.3</em></li>
|
|
<li><a href="#nonlinux">Nexenta</a> <em>3.0.1</em></li>
|
|
</ul>
|
|
|
|
{% trans trac=i2pconv('trac.i2p2.i2p') -%}
|
|
The I2P packages <em>may</em> work on systems not listed above. Please report any issues
|
|
with these packages on <a href="http://{{ trac }}">Trac</a> at
|
|
<a href="http://{{ trac }}">http://{{ trac }}</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 systems based on Debian and older versions of Ubuntu){% endtrans %}</li>
|
|
<li>{% trans %}Option 3: <a href="#nonlinux">Non-Linux</a> (and possibly Non-x86 architectures){% endtrans %}</li>
|
|
</ul>
|
|
|
|
<h2 id="ubuntu">{{ _('Instructions for Ubuntu Lucid Lynx (and newer) and derivatives like Linux Mint & 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> 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> 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> sudo apt-get install i2p</code></li>
|
|
</ol>
|
|
|
|
<h5>{{ _('Adding the PPA Using Synaptic') }}</h5>
|
|
<ol>
|
|
<li>
|
|
{% trans -%}
|
|
Open Synaptic (System -> Administration -> 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 Lenny and newer') }}</h2>
|
|
|
|
{% trans -%}
|
|
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 %}
|
|
<ol>
|
|
<li>
|
|
{% trans %}Add the GPG key that signs the repository with the following command:{% endtrans %}<br />
|
|
<code> apt-key adv --keyserver keyserver.ubuntu.com --recv-keys <a href="http://keyserver.ubuntu.com:11371/pks/lookup?search=0x474BC46576FAE76E97C1A1A1AB9660B9EB2CC88B&op=index">EB2CC88B</a></code><br />
|
|
{% trans %}You'll have output like the following if the command was successful:{% endtrans %}<br />
|
|
<img src="{{ url_for('static', filename='images/add-key-terminal.png') }}" alt="" />
|
|
</li>
|
|
<li>
|
|
{% trans %}For Debian Oldstable (Lenny) and Stable (Squeeze): Add the following entries to <code>/etc/apt/sources.list.d/i2p.list</code>{% endtrans %}<br />
|
|
<code> deb http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu natty main <br />
|
|
deb-src http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu natty main </code><br />
|
|
<br />
|
|
{% trans %}For Debian Testing (Wheezy) or Unstable (Sid), use the following:{% endtrans %}<br />
|
|
<code> deb http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu precise main <br />
|
|
deb-src http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu precise main </code><br />
|
|
</li>
|
|
<li>
|
|
{% trans %}Notify your package manager of the new PPA by entering{% endtrans %}<br />
|
|
<code> 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 PPA added in step
|
|
1.
|
|
{%- endtrans %}
|
|
</li>
|
|
<li>
|
|
{% trans %}You are now ready to install I2P!{% endtrans %}<br />
|
|
<code> apt-get install i2p</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="nonlinux">{{ _('Instructions for Non-Linux / Non-x86') }}</h2>
|
|
|
|
{% trans -%}
|
|
The steps below should be performed with root access (i.e., switching
|
|
user to root with "<code>su</code>" or by prefixing each command with "<code>sudo</code>").
|
|
{%- endtrans %}<br />
|
|
<ol>
|
|
<li>
|
|
{% trans -%}
|
|
Download the <a href="http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu/pool/main/i/i2p/">i2p-router</a> package from the <a href="http://ppa.launchpad.net/i2p-maintainers/i2p/ubuntu/pool/main/i/i2p/">PPA</a>.
|
|
{%- endtrans %}
|
|
</li>
|
|
<li>
|
|
{% trans -%}
|
|
Make sure that you have Java installed. Running <em><code>apt-get install default-jre</code></em> should be sufficient.{% endtrans %}<br />
|
|
{% trans %}You are now ready to install I2P!{% endtrans %}<br />
|
|
<code> dpkg -i i2p-router_*.deb</code>
|
|
</li>
|
|
<li>
|
|
{% trans jbigi=site_url('misc/jbigi') -%}
|
|
It is recommended to compile <a href="{{ jbigi }}">jbigi</a> for your system to achieve better performance. Instructions are available <a href="{{ jbigi }}">here</a>.
|
|
{%- 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="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 -%}
|
|
"on demand" using the i2prouter script. Simply run "<code>i2prouter
|
|
start</code>" from a command prompt. (Note: Do <strong><u>not</u></strong> use
|
|
sudo or run it as root!)
|
|
{%- endtrans %}
|
|
</li>
|
|
<li>
|
|
{% trans -%}
|
|
"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 <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 <a href="http://www.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 %}
|