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