tor-relay

tor-relay

Docker app from not_a_real_human's Repository

Overview

This allows a tor to act as a relay on your Unraid system. It does NOT allow it to act as an exit node. It automatically enables account bandwidth tracking to prevent from using too much network bandwidth.

These are the container variables which can be modified:

IPV4_ONLY
OR_PORT
DIR_PORT
RELAY_BANDWIDTH_RATE
RELAY_BANDWIDTH_BURST
ACCOUNTING_MAX
ACCOUNTING_START
NICKNAME
CONTACT_INFO

A few defaults are pre-set, otherwise they are set by the container itself.

Two manual steps are required, in addition to one highly recommended configuration:

  1. (Step1) Users must create a data/ folder somewhere on their Unraid system, by default it is expected that this is at /mnt/user/appdata/tor-relay/data/
  2. (Step2) The root user must change the folder permissions to that of the unprivileged tor user. This is required for tor container to create a .tor folder to track bandwidth stats between reboots.
  3. (Configuration) Assign this container a static ip on the network, and forward the ports for OR_PORT and DIR_PORT to that static ip.

These two manual steps from above are:

mkdir -p /mnt/user/appdata/tor-relay/data/
sudo chown 100:100 /mnt/user/appdata/tor-relay/data/

The port forwarding configuration must be configured at the router.

Requirements

See overview.

Runtime arguments

Network
br0
Shell
sh
Privileged
false

Template configuration

OR PortPorttcp
Target
9001
Default
9001
Value
9001
DIR PortPorttcp
Target
9030
Default
9030
Value
9030
Server data directoryPathrw
Target
/var/lib/tor/
Default
/mnt/user/appdata/tor-relay/data/
Value
/mnt/user/appdata/tor-relay/data/
NICKNAMEVariable
Value
HelloWorldItsMe
ACCOUNTING_MAXVariable
Default
300 GBytes
Value
320 GBytes
RELAY_BANDWIDTH_RATEVariable
Default
512 KBytes
Value
512 KBytes
RELAY_BANDWIDTH_BURSTVariable
Default
1024 KBytes
Value
1024 KBytes

Download Statistics

1,072
Total Downloads

Details

Repository
mitchellthompkins/tor-relay:latest
Last Updated2026-05-01
First Seen2025-09-04

Run tor-relay on Unraid.

tor-relay is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.