fix a url in the sample torrc
[tor.git] / src / config / torrc.sample.in
blob473fd1699c55ef3e3bd1476836b9b1c2ab9ec879
1 ## Configuration file for a typical Tor user
2 ## Last updated 26 October 2005 for Tor 0.1.1.9-alpha.
3 ## (May or may not work for older or newer versions of Tor.)
5 ## See the man page, or http://tor.eff.org/tor-manual.html, for more
6 ## options you can use in this file.
8 # On Unix, Tor will look for this file in someplace like "~/.tor/torrc" or
9 # "/etc/torrc"
11 # On Windows, Tor will look for the configuration file in someplace like
12 # "Application Data\tor\torrc" or "Application Data\<username>\tor\torrc"
14 # With the default Mac OS X installer, Tor will look in ~/.tor/torrc or
15 # /Library/Tor/torrc
18 ## Replace this with "SocksPort 0" if you plan to run Tor only as a
19 ## server, and not make any local application connections yourself.
20 SocksPort 9050 # what port to open for local application connections
21 SocksListenAddress 127.0.0.1 # accept connections only from localhost
22 #SocksListenAddress 192.168.0.1:9100 # listen on a chosen IP/port too
24 ## Entry policies to allow/deny SOCKS requests based on IP address.
25 ## First entry that matches wins. If no SocksPolicy is set, we accept
26 ## all (and only) requests from SocksListenAddress.
27 #SocksPolicy accept 192.168.0.1/16
28 #SocksPolicy reject *
30 ## Allow no-name routers (ones that the dirserver operators don't
31 ## know anything about) in only these positions in your circuits.
32 ## Other choices (not advised) are entry,exit,introduction.
33 AllowUnverifiedNodes middle,rendezvous
35 ## Logs go to stdout at level "notice" unless redirected by something
36 ## else, like one of the below lines. You can have as many Log lines as
37 ## you want.
39 ## Send all messages of level 'notice' or higher to @LOCALSTATEDIR@/log/tor/notices.log
40 #Log notice file @LOCALSTATEDIR@/log/tor/notices.log
41 ## Send every possible message to @LOCALSTATEDIR@/log/tor/debug.log
42 #Log debug file @LOCALSTATEDIR@/log/tor/debug.log
43 ## Send only debug and info messages to @LOCALSTATEDIR@/log/tor/debug.log
44 #Log debug-info file @LOCALSTATEDIR@/log/tor/debug.log
45 ## Send ONLY debug messages to @LOCALSTATEDIR@/log/tor/debug.log
46 #Log debug-debug file @LOCALSTATEDIR@/log/tor/debug.log
47 ## Use the system log instead of Tor's logfiles
48 #Log notice syslog
49 ## To send all messages to stderr:
50 #Log debug stderr
52 ## Uncomment this to start the process in the background... or use
53 ## --runasdaemon 1 on the command line. This is ignored on Windows;
54 ## see the FAQ entry if you want Tor to run as an NT service.
55 #RunAsDaemon 1
57 ## The directory for keeping all the keys/etc. By default, we store
58 ## things in $HOME/.tor on Unix, and in Application Data\tor on Windows.
59 #DataDirectory @LOCALSTATEDIR@/lib/tor
61 ## The port on which Tor will listen for local connections from Tor controller
62 ## applications, as documented in control-spec.txt.  NB: this feature is
63 ## currently experimental.
64 #ControlPort 9051
66 ############### This section is just for location-hidden services ###
68 ## Look in .../hidden_service/hostname for the address to tell people.
69 ## HiddenServicePort x y:z says to redirect a port x request from the
70 ## client to y:z.
72 #HiddenServiceDir @LOCALSTATEDIR@/lib/tor/hidden_service/
73 #HiddenServicePort 80 127.0.0.1:80
75 #HiddenServiceDir @LOCALSTATEDIR@/lib/tor/other_hidden_service/
76 #HiddenServicePort 80 127.0.0.1:80
77 #HiddenServicePort 22 127.0.0.1:22
78 #HiddenServiceNodes moria1,moria2
79 #HiddenServiceExcludeNodes bad,otherbad
81 ################ This section is just for servers #####################
83 ## NOTE: If you enable these, you should consider mailing your identity
84 ## key fingerprint to the tor-ops, so we can add you to the list of
85 ## servers that clients will trust. See
86 ## http://tor.eff.org/cvs/tor/doc/tor-doc-server.html for details.
88 ## Required: A unique handle for this server
89 #Nickname ididnteditheconfig
91 ## The IP or fqdn for this server. Leave commented out and Tor will guess.
92 #Address noname.example.com
94 ## Contact info that will be published in the directory, so we can
95 ## contact you if you need to upgrade or if something goes wrong.
96 ## This is optional but recommended.
97 #ContactInfo Random Person <nobody AT example dot com>
98 ## You might also include your PGP or GPG fingerprint if you have one:
99 #ContactInfo 1234D/FFFFFFFF Random Person <nobody AT example dot com>
101 ## Required: what port to advertise for tor connections
102 #ORPort 9001
103 ## If you want to listen on a port other than the one advertised
104 ## in ORPort (e.g. to advertise 443 but bind to 9090), uncomment
105 ## the line below. You'll need to do ipchains or other port forwarding
106 ## yourself to make this work.
107 #ORListenAddress 0.0.0.0:9090
109 ## Uncomment this to mirror the directory for others (please do)
110 #DirPort 9030 # what port to advertise for directory connections
111 ## If you want to listen on a port other than the one advertised
112 ## in DirPort (e.g. to advertise 80 but bind 9091), uncomment the line
113 ## below. You'll need to do ipchains or other port forwarding yourself
114 ## to make this work.
115 #DirListenAddress 0.0.0.0:9091
117 ## Uncomment this if you run more than one Tor server, and add the
118 ## nickname of each Tor server you control, even if they're on different
119 ## networks. We declare it here so clients can avoid using more than
120 ## one of your servers in a given circuit.
121 #MyFamily nickname1,nickname2,...
123 ## A comma-separated list of exit policies. They're considered first
124 ## to last, and the first match wins. If you want to *replace*
125 ## the default exit policy, end this with either a reject *:* or an
126 ## accept *:*. Otherwise, you're *augmenting* (prepending to) the
127 ## default exit policy. Leave commented to just use the default, which is
128 ## available in the man page or at http://tor.eff.org/documentation.html
130 ## Look at http://tor.eff.org/faq-abuse.html#TypicalAbuses
131 ## for issues you might encounter if you use the default exit policy.
133 ## If certain IPs and ports are blocked externally, e.g. by your firewall,
134 ## you should update your exit policy to reflect this -- otherwise Tor
135 ## users will be told that those destinations are down.
137 #ExitPolicy accept *:6660-6667,reject *:* # allow irc ports but no more
138 #ExitPolicy accept *:119 # accept nntp as well as default exit policy
139 #ExitPolicy reject *:* # middleman only -- no exits allowed