Hi,

ansible-relayor is an ansible [1] role for tor relay operators.

Whether you setup/operate a single or many relays, ansible-relayor can help you automate all steps including secure offline key [2] generation, multi-instance setup and MyFamily management.

https://github.com/nusenu/ansible-relayor

Main benefits for a tor relay operator ======================================

* security: Ed25519 master keys are kept offline * easy key renewal with a single command * security: every tor instance is run with a distinct user * automatically makes use of IPv6 IPs (if available) * automatic MyFamily management * automatic multi-instance setup (configurable) * easily restore/move a relay

Supported Platforms ===================

* FreeBSD 10.x * OpenBSD 5.9 * Debian 8 * Ubuntu 16.04 * CentOS 7 * Fedora 23

Installation ============

relayor is available via ansible-galaxy:

ansible-galaxy install nusenu.relayor

https://galaxy.ansible.com/nusenu/relayor/

Documentation ==============

https://github.com/nusenu/ansible-relayor/blob/master/README.md https://github.com/nusenu/ansible-relayor/wiki

playbook examples: https://github.com/nusenu/ansible-relayor/wiki/relayor-playbook-examples

migration steps for existing relays https://github.com/nusenu/ansible-relayor/wiki/Migration-Steps

git tags are signed with:

pub 4096R/4D705DE9 2016-02-11 Key fingerprint = A7B5 DB91 CE04 C9E0 BE66 446B 8CBE 52BD 4D70 5DE9 uid ansible-relayor signing key (https://github.com/nusenu/ansible-relayor)

regards, nusenu

[1] https://docs.ansible.com/ansible/intro_getting_started.html [2] https://trac.torproject.org/projects/tor/wiki/doc/TorRelaySecurity/Offli neKeys