docs/en/debian.wml
2a9aaa80
 ## translation metadata
 # Revision: $Revision: 22268 $
 # Translation-Priority: 3-low
 
 #include "head.wmi" TITLE="Tor Project: Debian/Ubuntu Instructions" CHARSET="UTF-8"
 <div id="content" class="clearfix">
   <div id="breadcrumbs">
b289ef06
     <a href="<page index>">Home &raquo; </a>
2a9aaa80
     <a href="<page docs/documentation>">Documentation &raquo; </a>
     <a href="<page docs/debian>">Debian/Ubuntu Instructions</a>
   </div>
   <div id="maincol"> 
     <a id="debian"></a>
     <h2><a class="anchor" href="#debian">Option one: Tor on Debian lenny,
     Debian sid, or Debian testing</a></h2>
ed5ac546
     <br>
2a9aaa80
     
     <p>
     If you're using Debian stable (lenny), unstable (sid), or testing
ed5ac546
     (squeeze), just run<br>
2a9aaa80
     <tt>apt-get install tor tor-geoipdb</tt>
     as root.
     </p>
     
     <p>
     Note that this might not always give you the latest stable Tor version, but
     you will receive important security fixes. To make sure that you're running
     the latest stable version of Tor, see option two below.
     </p>
     
     <p>
     Now Tor is installed and running. Move on to <a href="<page
     docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
     instructions.
     </p>
     
ed5ac546
     <hr>
2a9aaa80
     
     <a id="ubuntu"></a>
     <a id="packages"></a>
     <h2><a class="anchor" href="#ubuntu">Option two: Tor on Ubuntu or
     Debian</a></h2>
ed5ac546
     <br>
2a9aaa80
     
     <p>
     <b>Do not use the packages in Ubuntu's universe.</b> They are unmaintained
     and out of date. That means you'll be missing stability and security
     fixes.
     </p>
     
     <p>
     You'll need to set up our package repository before you can fetch
     Tor. First, you need to figure out the name of your distribution. If
     you're using Ubuntu 9.10 or 10.04, it's  "karmic", while 9.04 is "jaunty",
     8.10 is "intrepid", and 8.04 is "hardy". If you're using Debian
     Etch, it's "etch", and Debian Lenny is "lenny". Then add this line to your
     <tt>/etc/apt/sources.list</tt>
ed5ac546
     file:<br>
2a9aaa80
     <pre>
     deb     http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
     </pre>
     where you put the codename of your distribution (i.e. etch, lenny, sid, karmic,
     jaunty, intrepid, hardy or whatever it is) in place of &lt;DISTRIBUTION&gt;.
     </p>
     
     <p>
     Then add the gpg key used to sign the packages by running the following
     commands at your command prompt:
     <pre>
     gpg --keyserver keys.gnupg.net --recv 886DDD89
     gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
     </pre>
     Now refresh your sources and install Tor by running the following
     commands at your command prompt:
     <pre>
     apt-get update
     apt-get install tor tor-geoipdb
     </pre>
     </p>
     
     <p>
     Now Tor is installed and running. Move on to <a href="<page
     docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
     instructions.
     </p>
     
     <p style="font-size: small">
     The DNS name <code>deb.torproject.org</code> is actually a set of independent
     servers in a DNS round robin configuration.  If you for some reason cannot
     access it you might try to use the name of one of its part instead.  Try
     <code>deb-master.torproject.org</code>,
     <code>mirror.netcologne.de</code> or
     <code>tor.mirror.youam.de</code>.
     </p>
     
ed5ac546
     <hr>
2a9aaa80
     
     <a id="development"></a>
     <h2><a class="anchor" href="#development">Option three: Using the
     development branch of Tor on Debian or Ubuntu</a></h2>
ed5ac546
     <br>
2a9aaa80
     
     <p>If you want to use the <a href="<page
     download/download>#packagediff">development branch</a> of Tor instead (more
     features and more bugs), you need to add a different set of lines to
ed5ac546
     your <tt>/etc/apt/sources.list</tt> file:<br>
2a9aaa80
     <pre>
     deb     http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
     deb     http://deb.torproject.org/torproject.org experimental-&lt;DISTRIBUTION&gt; main
     </pre>
     where you again substitute the name of your distro (etch, lenny, sid, karmic,
     jaunty, intrepid, hardy) in place of &lt;DISTRIBUTION&gt;.
     </p>
     
     <p>
     Then run the following commands at your command prompt:
     <pre>
     gpg --keyserver keys.gnupg.net --recv 886DDD89
     gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
     apt-get update
     apt-get install tor tor-geoipdb
     </pre>
     </p>
     
     <p>
     Now Tor is installed and running. Move on to <a href="<page
     docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
     instructions.
     </p>
     
ed5ac546
     <hr>
2a9aaa80
     
     <a id="source"></a>
     <h2><a class="anchor" href="#source">Building from source</a></h2>
ed5ac546
     <br>
2a9aaa80
     
     <p>
     If you want to build your own debs from source you must first add an
     appropriate <tt>deb-src</tt> line to <tt>sources.list</tt>.
     <pre>
     # For the stable version.
     deb-src http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
     
     # For the unstable version.
     deb-src http://deb.torproject.org/torproject.org &lt;DISTRIBUTION&gt; main
     deb-src http://deb.torproject.org/torproject.org experimental-&lt;DISTRIBUTION&gt; main
     </pre>
     You also need to install the necessary packages to build your own debs and the
     packages needed to build Tor:
     <pre>
     apt-get install build-essential fakeroot devscripts
     apt-get build-dep tor
     </pre>
     Then you can build Tor in ~/debian-packages:
     <pre>
     mkdir ~/debian-packages; cd ~/debian-packages
     apt-get source tor
     cd tor-*
     debuild -rfakeroot -uc -us
     cd ..
     </pre>
     Now you can install the new package:
     <pre>
     sudo dpkg -i tor_*.deb
     </pre>
     </p>
     
     <p>
     Now Tor is installed and running. Move on to <a href="<page
     docs/tor-doc-unix>#polipo">step two</a> of the "Tor on Linux/Unix"
     instructions.
     </p>
     
ed5ac546
     <hr>
2a9aaa80
     
     <p>If you have suggestions for improving this document, please <a
     href="<page about/contact>">send them to us</a>. Thanks!</p>
   </div>
   <!-- END MAINCOL -->
   <div id = "sidecol">
 #include "side.wmi"
 #include "info.wmi"
   </div>
   <!-- END SIDECOL -->
 </div>
 <!-- END CONTENT -->
 #include <foot.wmi>