Skip to content

Releases: eyedeekay/reseed-tools

v0.2.33

28 Jan 01:43
@eyedeekay eyedeekay
v0.2.33
f89dd04
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.33 Latest
Latest

I2P Reseed Tools

Reseed Tools Poster

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

It is possible to create a .deb package using these instructions.

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 22

v0.2.32

28 Jan 00:50
@eyedeekay eyedeekay
v0.2.32
1568193
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.32

I2P Reseed Tools

Reseed Tools Poster

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

It is possible to create a .deb package using these instructions.

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 22

v0.2.30

04 Jan 03:45
@eyedeekay eyedeekay
v0.2.30
4ff9439
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.30

I2P Reseed Tools

Reseed Tools Poster

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

After installing the plugin, you should immediately edit the $PLUGIN/signer
file in order to set your --signer email, which is used to name your keys.
You can find the $PLUGIN directory in your I2P config directory, which is
usually $HOME/.i2p on Unixes.

This will allow the developers to contact you if your reseed has issues
and will authenticate your reseed to the I2P routers that use it.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Service Integration

Support for running as a system service as part of the reseed package
is new. PR's that improve integration are welcome.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 22

v0.2.13

02 Apr 00:06
@eyedeekay eyedeekay
v0.2.13
8da5f98
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.13

I2P Reseed Tools

Reseed Tools Poster

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

After installing the plugin, you should immediately edit the $PLUGIN/signer
file in order to set your --signer email, which is used to name your keys.
You can find the $PLUGIN directory in your I2P config directory, which is
usually $HOME/.i2p on Unixes.

This will allow the developers to contact you if your reseed has issues
and will authenticate your reseed to the I2P routers that use it.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Service Integration

Support for running as a system service as part of the reseed package
is new. PR's that improve integration are welcome.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 4

v0.2.11

15 Dec 04:53
@eyedeekay eyedeekay
v0.2.11
5e5c9c0
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.11

I2P Reseed Tools

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

After installing the plugin, you should immediately edit the $PLUGIN/signer
file in order to set your --signer email, which is used to name your keys.
You can find the $PLUGIN directory in your I2P config directory, which is
usually $HOME/.i2p on Unixes.

This will allow the developers to contact you if your reseed has issues
and will authenticate your reseed to the I2P routers that use it.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 21

v0.2.10

15 Dec 00:14
@eyedeekay eyedeekay
v0.2.10
6249b3f
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.10

I2P Reseed Tools

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

After installing the plugin, you should immediately edit the clients.config
file in order to set your --signer email, which is used to name your keys.
For example, change:

clientApp.0.main=net.i2p.app.CorrectedShellService
clientApp.0.name=reseed-tools-linux-amd64
clientApp.0.args=$PLUGIN/lib/reseed-tools-linux-amd64 -shellservice.name "reseed-tools-linux-amd64" -shellservice.displayname "Reseed Tools" reseed --yes --signer=you@mail.i2p --port=7671
^ change this line
clientApp.0.delay=86400
clientApp.0.startOnLoad=true
clientApp.0.classpath=$PLUGIN/lib/shellservice.jar

into:

clientApp.0.main=net.i2p.app.CorrectedShellService
clientApp.0.name=reseed-tools-linux-amd64
clientApp.0.args=$PLUGIN/lib/reseed-tools-linux-amd64 -shellservice.name "reseed-tools-linux-amd64" -shellservice.displayname "Reseed Tools" reseed --yes --signer=hankhill19580@gmail.com --port=7671
^ fill in your email
clientApp.0.delay=86400
^ remove this line when you're done
clientApp.0.startOnLoad=true
clientApp.0.classpath=$PLUGIN/lib/shellservice.jar

This will allow the developers to contact you if your reseed has issues
and authenticate your reseed.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 26

v0.2.9

14 Dec 22:25
@eyedeekay eyedeekay
v0.2.9
bd4f7d7
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.9

I2P Reseed Tools

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 26

v0.2.8

13 Dec 15:24
@eyedeekay eyedeekay
v0.2.8
acaf528
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.8

I2P Reseed Tools

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 26

v0.2.7

12 Dec 02:08
@eyedeekay eyedeekay
v0.2.7
7b27889
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.7

I2P Reseed Tools

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 26

v0.2.6

09 Dec 22:53
@eyedeekay eyedeekay
v0.2.6
a734aef
This commit was signed with the committer’s verified signature.
eyedeekay idk
GPG key ID: D75C03B39B5E14E1
Learn about vigilant mode.
Compare
Choose a tag to compare
v0.2.6

I2P Reseed Tools

This tool provides a secure and efficient reseed server for the I2P network.
There are several utility commands to create, sign, and validate SU3 files.
Please note that this requires at least Go version 1.13, and uses Go Modules.

Standard reseeds are distributed with the I2P packages. To get your reseed
included, apply on zzz.i2p.

Dependencies

go, git, and optionally make are required to build the project.
Precompiled binaries for most platforms are available at my github mirror
https://github.com/eyedeekay/i2p-tools-1.

In order to install the build-dependencies on Ubuntu or Debian, you may use:

sudo apt-get install golang-go git make

Installation

Reseed-tools can be run as a user, as a freestanding service, or be installed
as an I2P Plugin. It will attempt to configure itself automatically. You should
make sure to set the --signer flag or the RESEED_EMAIL environment variable
to configure your signing keys/contact info.

Plugin install URL's

Plugin releases are available inside of i2p at http://idk.i2p/reseed-tools/
and via the github mirror at https://github.com/eyedeekay/reseed-tools/releases.
These can be installed by adding them on the
http://127.0.0.1:7657/configplugins.

Installation(From Source)

git clone https://i2pgit.org/idk/reseed-tools
cd reseed-tools
make build
# Optionally, if you want to install to /usr/bin/reseed-tools
sudo make install

Usage

Debian/Ubuntu note:

Debian users who are running I2P as a system service must also run the
reseed-tools as the same user. This is so that the reseed-tools can access
the I2P service's netDb directory. On Debian and Ubuntu, that user is i2psvc
and the netDb directory is: /var/lib/i2p/i2p-config/netDb.

Systemd Service

A systemd service is provided which should work with the I2P Debian package
when reseed-tools is installed in /usr/bin/reseed-tools. If you install with
make install this service is also installed. This service will cause the
bundles to regenerate every 12 hours.

The contact email for your reseed should be added in:
/etc/systemd/system/reseed.d/reseed.conf.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/systemd/system/reseed.d/reseed.service.

  • To enable starting the reseed service automatically with the system: sudo systemctl enable reseed.service
  • To run the service manually: sudo sysctl start reseed.service
  • To reload the systemd services: sudo systemctl daemon-reload
  • To view the status/logs: sudo journalctl -u reseed.service
SysV Service

An initscript is also provided. The initscript, unlike the systemd service,
cannot schedule itself to restart. You should restart the service roughly once
a day to ensure that the information does not expire.

The contact email for your reseed should be added in:
/etc/init.d/reseed.

Self-signed certificates will be auto-generated for these services. To change
this you should edit the /etc/init.d/reseed.

Example Commands:

Without a webserver, standalone with TLS support

If this is your first time running a reseed server (ie. you don't have any existing keys),
you can simply run the command and follow the prompts to create the appropriate keys, crl and certificates.
Afterwards an HTTPS reseed server will start on the default port and generate 6 files in your current directory
(a TLS key, certificate and crl, and a su3-file signing key, certificate and crl).

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --tlsHost=your-domain.tld

Locally behind a webserver (reverse proxy setup), preferred:

If you are using a reverse proxy server it may provide the TLS certificate instead.

reseed-tools reseed --signer=you@mail.i2p --netdb=/home/i2p/.i2p/netDb --port=8443 --ip=127.0.0.1 --trustProxy
Assets 26