pyseeder
========

Reseed data managment tools for I2P

* Generate reseed signing keypair
* Make reseed data files (su3)
* Download su3 files from official servers for mirroring
* Upload reseed data to different places (with plugins)
* Run HTTPS reseed server

Reseed transports are implemented so that users can bootstrap their I2P nodes
without needing to connect to "official" I2P reseeds. This makes I2P more
invisible for firewalls.

Installation
------------

    $ pip3 install https://github.com/PurpleI2P/pyseeder/zipball/master

[Detailed installation instructions](INSTALL.md)


Usage
-----

    $ pyseeder --help
    $ pyseeder keygen --help


Generating keypair
------------------


    $ pyseeder keygen --cert data/user_at_mail.i2p.crt --private-key data/priv_key.pem --signer-id user@mail.i2p

This will generate certificate (user\_at\_mail.i2p.crt) and private RSA key
(priv\_key.pem) in data folder. E-mail is used as certificate identifier.

Script will prompt for private key password.


Generating reseed data
----------------------


    $ YOUR_PASSWORD="Pa55w0rd"
    $ echo $YOUR_PASSWORD | pyseeder reseed --netdb /path/to/netDb --private-key data/priv_key.pem --outfile output/i2pseeds.su3 --signer-id user@mail.i2p

This will generate file i2pseeds.su3 in output folder, using user@mail.i2p as
certificate identifier.

Note:  you'll have to enter your private key password to stdin, the above
is one of the ways to do it (for cron and scripts).


Download su3 file from official servers
---------------------------------------

    $ pyseeder transport.pull --urls https://reseed.i2p-projekt.de/ https://reseed.i2p.vzaws.com:8443/ --outfile output/i2pseeds.su3

Note: --urls parameter is optional, defaults are "official" I2P reseeds.


Upload su3 file with pluggable transports
-----------------------------------------

    $ pyseeder transport.push --config transports.ini --file output/i2pseeds.su3

All parameters are optional. Copy file transports.ini.example to 
transports.ini. Edit your settings in this new file.


Run HTTPS reseed server
-----------------------

    $ pyseeder serve --port 8443 --host 127.0.0.1 --private-key data/priv_key.pem --cert data/user_at_mail.i2p.crt --file output/i2pseeds.su3

Note: this server is fine for testing, but for "production" environments please
use nginx webserver.