tor-webwml.git

1) ## translation metadata

2) # Revision: $Revision$

3) # Translation-Priority: 3-low
4) 
5) #include "head.wmi" TITLE="Vidalia: Debian/Ubuntu Instructions" CHARSET="UTF-8"
6) <div id="content" class="clearfix">
7)   <div id="breadcrumbs">

8)     <a href="<page index>">Home &raquo; </a>

9)     <a href="<page docs/documentation>">Documentation &raquo; </a>
10)     <a href="<page docs/debian-vidalia>">Vidalia Debian/Ubuntu Instructions</a>
11)   </div>
12)   <div id="maincol"> 

13) <a id="debian"></a>
14) <a id="packages"></a>
15) <h2><a class="anchor" href="#debian">Vidalia on Ubuntu or Debian</a></h2>
16) <br />
17) 
18) <p>
19) <b>Do not use the packages in Ubuntu's universe.</b> They are unmaintained
20) and out of date. That means you'll be missing stability and security
21) fixes.
22) </p>
23) 
24) <p>
25) You'll need to set up our package repository before you can fetch
26) Tor. First, you need to figure out the name of your distribution. Here's
27) a quick mapping:
28) <ul>

29) <li> Ubuntu 11.04 is "natty"</li>
30) <li> Ubuntu 10.10 or Trisquel 4.5 is "maverick"</li> 

31) <li> Ubuntu 10.04 or Trisquel 4.0 is "lucid"</li>
32) <li> Ubuntu 9.10 or Trisquel 3.5 is  "karmic"</li>
33) <li> Ubuntu 9.04 is "jaunty"</li>
34) <li> Ubuntu 8.10 is "intrepid"</li>
35) <li> Ubuntu 8.04 is "hardy"</li> 
36) <li> Debian Etch is "etch"</li>
37) <li> Debian Lenny is "lenny"</li>
38) </ul>
39) 
40) Then add this line to your
41) <tt>/etc/apt/sources.list</tt>
42) file:<br />
43) <pre>
44) deb     http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
45) </pre>
46) where you substitute the above word (etch, lenny, sid, karmic, jaunty,
47) intrepid, hardy) in place of &lt;DISTRIBUTION&gt;.
48) </p>
49) 
50) <p>
51) Then add the gpg key used to sign the packages by running the following
52) commands at your command prompt:
53) <pre>
54) gpg --keyserver keys.gnupg.net --recv 886DDD89
55) gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
56) </pre>
57) Now refresh your sources and install Vidalia by running the following
58) commands at your command prompt:
59) <pre>
60) apt-get update
61) apt-get install vidalia 
62) </pre>
63) </p>
64) 
65) <p>
66) Now Vidalia is installed and running. Move on to <a href="<page
67) docs/tor-doc-unix>#polipo">step two</a> of the "Vidalia on Linux/Unix"
68) instructions.
69) </p>
70) 
71) <p style="font-size: small">
72) The DNS name <code>deb.torproject.org</code> is actually a set of independent
73) servers in a DNS round robin configuration.  If you for some reason cannot
74) access it you might try to use the name of one of its part instead.  Try
75) <code>deb-master.torproject.org</code>,
76) <code>mirror.netcologne.de</code> or
77) <code>vidalia.mirror.youam.de</code>.
78) </p>
79) 
80) <hr />
81) 
82) <a id="source"></a>
83) <h2><a class="anchor" href="#source">Building from source</a></h2>
84) <br />
85) 
86) <p>
87) If you want to build your own debs from source you must first add an
88) appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.
89) <pre>
90) deb-src http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
91) </pre>
92) You also need to install the necessary packages to build your own debs and the
93) packages needed to build Vidalia:
94) <pre>
95) apt-get install build-essential fakeroot devscripts qt4-dev-tools qt4-designer libqt4-dev g++ cmake
96) apt-get build-dep vidalia
97) </pre>
98) Then you can build Vidalia in ~/debian-packages:
99) <pre>
100) mkdir ~/debian-packages; cd ~/debian-packages
101) apt-get source vidalia
102) cd vidalia-*
103) debuild -rfakeroot -uc -us
104) cd ..
105) </pre>
106) Now you can install the new package:
107) <pre>
108) sudo dpkg -i vidalia_*.deb
109) </pre>
110) </p>
111) 
112) <p>
113) Now Vidalia is installed and running. Move on to <a href="<page
114) docs/tor-doc-unix>#polipo">step two</a> of the "Vidalia on Linux/Unix"
115) instructions.
116) </p>
117) 
118) <hr />
119) 
120) <p>If you have suggestions for improving this document, please <a
121) href="<page about/contact>">send them to us</a>. Thanks!</p>
122)