Update README.md

master
jarlave 7 years ago committed by GitHub
parent 0d67c1da18
commit cb2b96f00d

@ -1,3 +1,53 @@
Docker image to setup a Tor relay with [nyx](https://nyx.torproject.org/) monitoring
==============================================
![Docker Build Status](https://img.shields.io/docker/cloud/build/jarlave/tor-relay-nyx.svg)
![Docker Image Size](https://img.shields.io/microbadger/image-size/jarlave/tor-relay-nyx.svg)
### Middle relay
```bash
docker run -d \
--restart always \
-v tor-relay-data:/home/tor/data:rw
-v /etc/localtime:/etc/localtime:ro \
-p 9001:9001 \
-e RELAY_NICKNAME='ChangeMe' \
-e CONTACT_EMAIL='tor[at]example[dot]com' \
--name tor-relay \
jarlave/tor-relay-nyx
```
### Bridge relay
```bash
docker run -d \
--restart always \
-v tor-relay-data:/home/tor/data:rw
-v /etc/localtime:/etc/localtime:ro \
-p 9001:9001 \
-e RELAY_TYPE='bridge' \
-e RELAY_NICKNAME='ChangeMe' \
-e CONTACT_EMAIL='tor[at]example[dot]com' \
--name tor-relay \
jarlave/tor-relay-nyx
```
### Exit relay
```bash
docker run -d \
--restart always \
-v tor-relay-data:/home/tor/data:rw
-v /etc/localtime:/etc/localtime:ro \
-p 9001:9001 \
-e RELAY_TYPE='exit' \
-e RELAY_NICKNAME='ChangeMe' \
-e CONTACT_EMAIL='tor[at]example[dot]com' \
--name tor-relay \
jarlave/tor-relay-nyx
```
### Environment variables
| Name | Description | Default value |
@ -13,4 +63,10 @@
| **RELAY_DIRPORT** | Default port used for directory (DirPort) | 9030 |
| **RELAY_CTRLPORT** | Default port used for control interface (ControlPort) | 9051 |
| **RELAY_ACCOUNTING_MAX** | Default threshold for sent and recieve (AccountingMax) | 1 GBytes |
| **RELAY_ACCOUNTING_START** | threshold rest (AccountingStart) | day 00:00 |
| **RELAY_ACCOUNTING_START** | threshold rest (AccountingStart) | day 00:00 |
### Open nyx
```bash
docker exec -it tor-relay nyx
```

Loading…
Cancel
Save