tor-info

The files needed to extend RPi-Monitor and show a Tor relay's bandwidth information.

Introduction

RPi-Monitor is a nice monitoring tool for your Raspberry Pi. It provides a web view where you can watch things such as memory, CPU and temperature. If your RPi is running a Tor relay then you can easily extend RPi-Monitor to show how much bandwidth the relay is consumig, the observed bandwidth, the relay's address and so on.

License

These files may be used under the terms of the MIT License, wich a copy is included in the download.

Dependencies

Python 2.6 or greater
Stem 1.2.2 or greater
Supervisor

Configuration

Copy tor.conf to /etc/rpimonitor/template/
Add the following line to /etc/rpimonitor/data.conf

include=/etc/rpimonitor/template/tor.conf

Copy tor.png to /usr/share/rpimonitor/web/img
Copy tor-bw.conf and tor-desc.conf to /etc/supervisor/conf.d/
Run sudo groupadd supervisor;sudo usermod -a -G supervisor pi
Modify /etc/supervisor/supervisord.conf with the following:

[unix_http_server]
file=/var/run/supervisor.sock
chmod=0770
chown=root:supervisor

Run sudo mkdir /usr/local/sbin/rpimonitor/
Copy tor-bw.py and tor-desc.pyto /usr/local/sbin/rpimonitor
Set your connection parameters on tor-bw.py (TOR_CONTROL_PORT, TOR_ADDRESS and TOR_CONTROLLER_PASSWD)
Set your relay's fingerprint on tor-desc.py (FINGERPRINT)
Logout/login and run sudo service supervisor restart;sudo service rpimonitor restart

The traffic graph shows the values of RelayBandwidthRate and RelayBandwidthBurst if these parameters are set in torrc.

Your Improvements

If you add improvements to these files please send them to me as pull requests on GitHub. I will add them to the next release so that everyone can enjoy your work. You might also benefit from it as others may fix bugs in your files or may continue to enhance them.

Thanks

With regards from

Luiz Kill

lzkill / tor-info