|  |  | @ -1,3 +1,53 @@ | 
			
		
	
		
		
			
				
					
					|  |  |  |  |  |  |  | Docker image to setup a Tor relay with [nyx](https://nyx.torproject.org/) monitoring | 
			
		
	
		
		
			
				
					
					|  |  |  |  |  |  |  | ============================================== | 
			
		
	
		
		
			
				
					
					|  |  |  |  |  |  |  |  | 
			
		
	
		
		
			
				
					
					|  |  |  |  |  |  |  |  | 
			
		
	
		
		
			
				
					
					|  |  |  |  |  |  |  | 
 | 
			
		
	
		
		
			
				
					
					|  |  |  |  |  |  |  | ### 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 |  |  |  |  ### Environment variables | 
			
		
	
		
		
			
				
					
					|  |  |  | 
 |  |  |  | 
 | 
			
		
	
		
		
			
				
					
					|  |  |  | | Name                         | Description                                                                  | Default value | |  |  |  | | Name                         | Description                                                                  | Default value | | 
			
		
	
	
		
		
			
				
					|  |  | @ -13,4 +63,10 @@ | 
			
		
	
		
		
			
				
					
					|  |  |  | | **RELAY_DIRPORT**            | Default port used for directory (DirPort)                                    | 9030          | |  |  |  | | **RELAY_DIRPORT**            | Default port used for directory (DirPort)                                    | 9030          | | 
			
		
	
		
		
			
				
					
					|  |  |  | | **RELAY_CTRLPORT**           | Default port used for control interface (ControlPort)                        | 9051          | |  |  |  | | **RELAY_CTRLPORT**           | Default port used for control interface (ControlPort)                        | 9051          | | 
			
		
	
		
		
			
				
					
					|  |  |  | | **RELAY_ACCOUNTING_MAX**     | Default threshold for sent and recieve (AccountingMax)                       | 1 GBytes      | |  |  |  | | **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 | 
			
		
	
		
		
			
				
					
					|  |  |  |  |  |  |  | ``` | 
			
		
	
	
		
		
			
				
					|  |  | 
 |