6
** This file is part of Vidalia, and is subject to the license terms in the
7
** LICENSE file, found in the top level directory of this distribution. If
8
** you did not receive the LICENSE file with this file, you may obtain it
9
** from the Vidalia source package distributed by the Vidalia Project at
10
** http://www.torproject.org/projects/vidalia.html. No part of Vidalia,
11
** including this file, may be copied, modified, propagated, or distributed
12
** except according to the terms described in the LICENSE file.
17
<h1>Configuring Vidalia and Tor</h1>
21
Vidalia allows you to configure some of the most commonly modified aspects
22
of Vidalia and Tor. It also lets you set up and manage a <a
23
href="server.html">Tor relay</a> so you can help the Tor network grow.
27
<h3>General Settings</h3>
29
Settings on the <i>General</i> page are the most commonly modified settings.
32
<li><b>Tor Executable</b>: This is the Tor executable that Vidalia will run when
33
you select <i>Start</i> from the tray menu. If you have multiple versions of
34
Tor installed, you can tell Vidalia which version you would like to run by
35
clicking the <i>Browse</i> button and navigating to the particular Tor
36
installation you want.
38
<li><b>Startup Options</b>: This setting allows you to have Vidalia
39
automatically start Tor when Vidalia starts. You can also configure Vidalia
40
to run when your system starts (<i>Windows only</i>).
45
<h3>Network Settings</h3>
47
The <i>Network</i> settings page lets you change how Tor connects to the Tor
51
<li><b>I use a proxy to access the Internet</b>: If your Internet connection
52
requires an HTTP proxy, you can configure Tor to send all of its directory
53
requests and Tor relay connections through your proxy. You must specify at
54
least the hostname or address of your proxy, and the port on which your
55
proxy is listening for connections. If your proxy requires authentication,
56
you can also enter the <i>Username</i> and <i>Password</i> you use to
57
connect to your proxy. Otherwise, you can leave those fields blank.
59
<li><b>My firewall only lets me connect to certain ports</b>: If you are behind
60
a restrictive firewall or proxy that limits the ports you are able to
61
connect to, you can configure Tor to connect directly only to relays
62
listening on the ports allowed by your firewall or proxy. Simply enter a
63
list of ports permitted by your firewall or proxy, separated by
64
commas. (<i>Example: 80,443,8080</i>)
66
<li><b>My ISP blocks connections to the Tor network</b>: If your ISP (Internet
67
Service Provider) blocks connections to the Tor network, Tor can attempt to
68
avoid being filtered by encrypting its directory connections and connecting
69
to the Tor network through relays called <i>bridges</i> (Tor 0.2.0.3-alpha
70
or newer only). You can add bridge relays by specifying either their address
71
and port number, or their address, port number, and fingerprint.<br/>
73
Below are examples of valid bridge address formats:
79
128.213.48.13:8080 1054 13B1 DBDA F867 B226 74D2 52DF 3D9F A367 1F73
82
128.213.48.13:8080 105413B1DBDAF867B22674D252DF3D9FA3671F73
85
Even if you do not know any bridge relay addresses, checking this checkbox
86
may still be helpful. Tor will encrypt its directory requests, which can
87
defeat blocking mechanisms that try to filter Tor's requests for information
88
about other relays. If connections to normal Tor relays are also blocked,
89
then you will need to learn a bridge relay address somehow and add it
90
here. See the help topic on <a href="bridges.html#finding">finding bridge
91
relays</a> for more information on how to learn new bridge relay addresses
97
<h3>Relay Settings</h3>
99
<i> See <a href="server.html">this help topic</a> for detailed information
100
about setting up and managing a Tor relay. </i>
103
<a name="appearance"/>
104
<h3>Appearance Settings</h3>
106
The settings on the <i>Appearance</i> page allow you to customize the look
110
<li><b>Language</b>: Vidalia's interface has been translated into many languages
111
by helpful volunteers. When Vidalia is first run, it will try to guess which
112
language your computer is currently using. If Vidalia guesses incorrectly,
113
or if you prefer a different language, you can choose another language from
114
the dropdown box. You will need to restart Vidalia after changing the
115
displayed language for the changes to take effect.
117
<li><b>Style</b>: In most cases, Vidalia will default to using your platform's
118
default interface style. If you dislike the default, you can choose
119
whichever interface style you prefer from the dropdown box.
124
<h3>Advanced Settings</h3>
126
The settings on the <i>Advanced</i> page should generally only be modified
127
by more experienced users.
130
<li><b>Control Address & Port</b>: The <i>Control Port</i> is the port which
131
Vidalia uses to talk to Tor. This doesn't need to be changed unless you
132
have a conflict with another service on your machine, or if you are using
133
Vidalia to control and monitor a Tor process running on another machine.
135
<li><b>Control Port Authentication</b>: Control port authentication is used to
136
limit the applications on your machine that can connect to and reconfigure
137
your Tor installation. The available authentication methods are:
140
<b>None</b> -- No authentication is required. Use of this option is
141
<b>strongly</b> discouraged. Any application or user on your computer can
142
reconfigure your Tor installation.
145
<b>Password</b> <i>(Default)</i> -- If this method is selected, you can
146
specify a password that Tor will require each time a user or application
147
connects to Tor's control port. If Vidalia starts Tor for you, you can have
148
Vidalia randomly generate a new password each time it starts Tor by checking
149
the <i>Randomly Generate</i> checkbox.
152
<b>Cookie</b> -- If cookie authentication is selected, Tor will write a file
153
(or, <i>cookie</i>) containing random bytes to its data directory when it
154
starts. Any user or application that tries to connect to Tor's control port
155
must be able to provide the contents of this cookie.
159
<li><b>Tor Configuration File</b> <i>(optional)</i>: You can use this option to
160
have Vidalia start Tor using a specific <i>torrc</i>, Tor's configuration
161
file. If you leave this field blank, Tor will uses its own default torrc
164
<li><b>Tor Data Directory</b> <i>(optional)</i>: You can specify the directory
165
in which Tor will store its saved data, such as cached Tor relay
166
information, Tor relay keys, and configuration files. If you leave this
167
field blank, Tor will use its own default data directory location.
169
<li><b>Permissions</b> <i>(optional, not available on Windows)</i>: If you enter
170
a value for <b>Run as User</b>, Tor will <i>setuid</i> to this user when it
171
starts. If you enter a value for <b>Run as Group</b>, Tor will
172
<i>setgid</i> to this group when it starts.
177
<h3>Hidden Service Settings</h3>
179
Hidden services allow you to provide any kind of TCP-based service, e.g. an
180
HTTP service, to others without revealing your IP address.