i2p.www/i2p2www/pages/site/get-involved/guides/reseed-debian.html

{% extends "global/layout.html" %}
{% block title %}{{ _('How to Set up a Reseed Server using a Debian Package') }}{% endblock %}
{% block lastupdated %}2023-01{% endblock %}
{% block content %}

<h2>{% trans %}General Information{% endtrans %}</h2>

<h4><a href="reseed-policy">To read the reseed policy, follow this link.</a></h4>
<h4><a href="reseed">Please see the general information for all reseed servers in addition to reading this section.</a></h4>

<h2>{% trans %}Reseed on Debian using {% endtrans %} <code>checkinstall</code>, <code>apt-get</code></h2>

  <p>
    It is possible to easily and automatically configure a reseed server
    with a self-signed certificate on any Debian-based operating system,
    including Ubuntu and it&rsquo;s downstreams. This is achieved using the
    <code>
      checkinstall
    </code>
    tool to set up the software dependencies and the operating system to
    run the
    <code>
      I2P
    </code>
    service and the
    <code>
      reseed
    </code>
    service.
  </p>
  <h2>
    Using a binary package
  </h2>
  <p>
    If you do not wish to build from source, you can use a binary package
    from me(idk). This package is built from this repo with the
    <code>
      make checkinstall
    </code>
    target and uploaded by me. I build it on an up-to-date Debian
    <code>
      sid
    </code>
    system
    at tag time. It contains a static binary and files for configuring it as a
    system service.
  </p>
  <pre><code class="language-sh">
wget https://github.com/eyedeekay/reseed-tools/releases/download/v0.2.30/reseed-tools_0.2.30-1_amd64.deb
# Obtain the checksum from the release web page and store it in the SHA256SUMS file
echo &quot;38941246e980dfc0456e066f514fc96a4ba25d25a7ef993abd75130770fa4d4d reseed-tools_0.2.30-1_amd64.deb&quot; &gt; SHA256SUMS
sha256sums -c SHA256SUMS
sudo apt-get install ./reseed-tools_0.2.30-1_amd64.deb
</code></pre>
  <h2>
    Building the
    <code>
      .deb
    </code>
    package from the source(Optional)
  </h2>
  <p>
    If your software is too old, it&rsquo;s possible that the binary package I build will
    not work for you. It&rsquo;s very easy to generate your own from the source code in this
    repository.
  </p>
  <p>

    <strong>
      1.
    </strong>
    Install the build dependencies
  </p>
  <pre><code class="language-sh">
sudo apt-get install fakeroot checkinstall go git make
</code></pre>
  <p>

    <strong>
      2.
    </strong>
    Clone the source code
  </p>
  <pre><code class="language-sh">
git clone https://i2pgit.org/idk/reseed-tools ~/go/src/i2pgit.org/idk/reseed-tools
</code></pre>
  <p>

    <strong>
      3.
    </strong>
    Generate the
    <code>
      .deb
    </code>
    package using the
    <code>
      make checkinstall
    </code>
    target
  </p>
  <pre><code class="language-sh">
cd ~/go/src/i2pgit.org/idk/reseed-tools
make checkinstall
</code></pre>
  <p>

    <strong>
      4.
    </strong>
    Install the
    <code>
      .deb
    </code>
    package
  </p>
  <pre><code class="language-sh">
sudo apt-get install ./reseed-tools_*.deb
</code></pre>
  <h2>
    Running the Service
  </h2>
  <p>

    <strong>
      1.
    </strong>
    First, ensure that the I2P service is already running. The longer the better,
    if you have to re-start the service, or if the service has very few peers, allow it to
    run for 24 hours before advancing to step
    <strong>
      2.
    </strong>
  </p>
  <pre><code class="language-sh">
sudo systemctl start i2p
# or, if you use sysvinit
sudo service i2p start
</code></pre>
  <p>

    <strong>
      2.
    </strong>
    Once your I2P router is &ldquo;Well-Integrated,&rdquo; start the reseed service.
  </p>
  <pre><code class="language-sh">
sudo systemctl start reseed
# or, if you use sysvinit
sudo service reseed start
</code></pre>
  <p>
    Your reseed will auto-configure with a self-signed certificate on port
    <code>
      :8443
    </code>
    . The
    certificates themselves are available in
    <code>
      /var/lib/i2p/i2p-config/reseed
    </code>
    . When
    you are ready, you should copy the
    <code>
      *.crt
    </code>
    files from that directory and share them
    witth the I2P community on
    <a href="http://zzz.i2p">
      <code>
        zzz.i2p
      </code>
    </a>
    . These will allow I2P users
    to authenticate your reseed services and secure the I2P network.
  </p>

{% endblock %}