From 51a89c450a27f5d1ed20c4c400a09e77b50235ab Mon Sep 17 00:00:00 2001 From: idk <hankhill19580@gmail.com> Date: Wed, 4 Jan 2023 22:36:39 +0000 Subject: [PATCH] Debian reseed install instructions --- .../get-involved/guides/reseed-debian.html | 171 ++++++++++++++++++ .../get-involved/guides/reseed-plugin.html | 10 + .../get-involved/guides/reseed-proxy.html | 10 + .../site/get-involved/guides/reseed.html | 2 +- 4 files changed, 192 insertions(+), 1 deletion(-) create mode 100644 i2p2www/pages/site/get-involved/guides/reseed-debian.html create mode 100644 i2p2www/pages/site/get-involved/guides/reseed-plugin.html create mode 100644 i2p2www/pages/site/get-involved/guides/reseed-proxy.html diff --git a/i2p2www/pages/site/get-involved/guides/reseed-debian.html b/i2p2www/pages/site/get-involved/guides/reseed-debian.html new file mode 100644 index 000000000..bb2934e14 --- /dev/null +++ b/i2p2www/pages/site/get-involved/guides/reseed-debian.html @@ -0,0 +1,171 @@ +{% extends "global/layout.html" %} +{% block title %}{{ _('How to Set up a Reseed Server using a Debian Package') }}{% endblock %} +{% block lastupdated %}2023-1{% endblock %} +{% block content %} + + <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’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. 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 +echo "38941246e980dfc0456e066f514fc96a4ba25d25a7ef993abd75130770fa4d4d reseed-tools_0.2.30-1_amd64.deb" > 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’s possible that the binary package I build will + not work for you. It’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 “Well-Integrated,” 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 %} diff --git a/i2p2www/pages/site/get-involved/guides/reseed-plugin.html b/i2p2www/pages/site/get-involved/guides/reseed-plugin.html new file mode 100644 index 000000000..cb4324258 --- /dev/null +++ b/i2p2www/pages/site/get-involved/guides/reseed-plugin.html @@ -0,0 +1,10 @@ +{% extends "global/layout.html" %} +{% block title %}{{ _('How to Set up a Reseed Server using an I2P Console Plugin') }}{% endblock %} +{% block lastupdated %}2023-1{% endblock %} +{% block content %} + +<h2>{% trans %}General Information{% endtrans %}</h2> + +<h2>{% trans %}Installation from Source Code{% endtrans %}</h2> + +{% endblock %} diff --git a/i2p2www/pages/site/get-involved/guides/reseed-proxy.html b/i2p2www/pages/site/get-involved/guides/reseed-proxy.html new file mode 100644 index 000000000..3632ce58a --- /dev/null +++ b/i2p2www/pages/site/get-involved/guides/reseed-proxy.html @@ -0,0 +1,10 @@ +{% extends "global/layout.html" %} +{% block title %}{{ _('How to Set up a Reseed Server using a Reverse Proxy') }}{% endblock %} +{% block lastupdated %}2023-1{% endblock %} +{% block content %} + +<h2>{% trans %}General Information{% endtrans %}</h2> + +<h2>{% trans %}Installation from Source Code{% endtrans %}</h2> + +{% endblock %} diff --git a/i2p2www/pages/site/get-involved/guides/reseed.html b/i2p2www/pages/site/get-involved/guides/reseed.html index cbb45242e..32a2d7a46 100644 --- a/i2p2www/pages/site/get-involved/guides/reseed.html +++ b/i2p2www/pages/site/get-involved/guides/reseed.html @@ -1,6 +1,6 @@ {% extends "global/layout.html" %} {% block title %}{{ _('How to Set up a Reseed Server') }}{% endblock %} -{% block lastupdated %}2021-12{% endblock %} +{% block lastupdated %}2023-1{% endblock %} {% block content %} <h2>{% trans %}General Information{% endtrans %}</h2> -- GitLab