l-n-s / super-i2p-server

🔮 Automagically deploy i2pd with some common hidden services

Super I2P server

Automagically deploy i2pd with some common hidden services

Following those instructions you can turn almost any server into I2P node with pre-configured hidden services.

Requirements

You will need to have a root shell on your server with SSH key authentication set up.

Supported server OSes:

• Ubuntu 16.04 LTS and newer
• Fedora 27 and newer
• Debian 9 (not tested, but should work)
• CentOS 7 (with caveats)
• probably more in future...

On your personal computer (not server!), Ansible IT automation software is required:

sudo apt install ansible

Setup

Clone the repo on your personal computer (not server!):

git clone https://github.com/l-n-s/super-i2p-server.git && cd super-i2p-server

Copy sample inventory file and replace dummy.server.host.name in it with hostname or IP address of your server.

cp inventory.ini.sample inventory.ini
vi inventory.ini

Usage

Now everything is ready, you can choose which services you would like to have. Available services:

• outproxy: Personal I2P proxy to use regular Internet -- tinyproxy
• ircd: anonymous IRC chat server -- ngircd
• ircbouncer: ZNC bouncer for better experience with IRC
• xmpp: Decentralized instant messaging server -- prosody with mod_darknet

If you want everything, just run:

ansible-playbook -i inventory.ini playbook.yml

Otherwise, specify desired services with --tags key:

ansible-playbook -i inventory.ini --tags="outproxy,xmpp" playbook.yml

After ansible-playbook will finish, you will have a file in results directory containing information about your I2P services. I'd advise you to change passwords instead of using generated ones.

(Using resulting services is out of scope of this manual, but there will probably be links to other resources in future.)

If you just need to install i2pd without any services:

ansible-playbook -i inventory.ini --tags="i2pd" --skip-tags="get_info" playbook.yml

If you already have i2pd installed AND if it is managed with init system (like systemd), you can try to install services without i2pd (on your own risk):

ansible-playbook -i inventory.ini --tags="ircd,ircbouncer" --skip-tags="i2pd" playbook.yml

Keep in mind, that you may have as many servers in your inventory file as you wish, Ansible will deploy Super I2P server on each one of them:

[all]
host.name
another.host.name
10.20.30.40

Learn more about Ansible in docs.