[or-cvs] the rest of the tor hidden service howto

arma at seul.org arma at seul.org
Sat Jul 23 08:08:00 UTC 2005

Update of /home2/or/cvsroot/tor/doc
In directory moria:/home/arma/work/onion/cvs/tor/doc

Modified Files:
Log Message:
the rest of the tor hidden service howto
minus the windows part that i can't do

Index: tor-hidden-service.html
RCS file: /home2/or/cvsroot/tor/doc/tor-hidden-service.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- tor-hidden-service.html	22 Jul 2005 22:23:45 -0000	1.1
+++ tor-hidden-service.html	23 Jul 2005 08:07:58 -0000	1.2
@@ -92,9 +92,11 @@
 <p>First, open your torrc file in your favorite text editor. (See <a
 FAQ entry</a> to learn what this means.) Go to the middle section and
-look for the line<br />
-<tt>############### This section is just for location-hidden services ###</tt><br />
+look for the line</p>
+############### This section is just for location-hidden services ###
 This section of the file consists of groups of lines, each representing
@@ -117,12 +119,92 @@
-HiddenServiceDir /home/yourname/hidserv/
+HiddenServiceDir /home/username/hidserv/
 HiddenServicePort 80 www.google.com:80
-<p>The above directory is for Windows people. OS X or Unix people should
-use <tt>/tmp/hidserv</tt> instead.
+<p>You're going to want to change the HiddenServiceDir line, so it
+points to an actual directory that you have read/write access to. Fill
+in your own username in place of "username". For
+example, in Windows you might pick:</p>
+HiddenServiceDir C:\Documents and Settings\username\hidden_service/
+HiddenServicePort 80 www.google.com:80
+<p>Now save the torrc, and restart your Tor.
+<p>If Tor starts up again, great. Otherwise, something is wrong. Look
+at your torrc for obvious mistakes like typos. Then double-check
+that the directory you picked is writeable by you. If it's still
+not working, you should look at the Tor logs for hints. (See <a
+FAQ entry</a> if you don't know how to enable or find your log file.)
+<p>When Tor starts, it will automatically create two files in the
+HiddenServiceDir that you specified. First, it will generate a new
+public/private keypair for your hidden service, and write it into a
+file called "private_key". Don't share this key with others -- if you
+do they will be able to impersonate your hidden service. If you plan to
+keep your service available for a long time, you might want to make a
+backup copy of the private_key somewhere.
+<p>The other file it will create is called "hostname". This contains
+a short summary of your public key -- it will look something like
+<tt>6sxoyfb3h2nvok2d.onion</tt>. This is the public name for your service,
+and you can tell it to people, publish it on websites, put it on business
+cards, etc.
+<p>Now that you've restarted Tor, it is busy picking introduction points
+in the Tor network, and generating what's called a "hidden service
+descriptor", which is a signed list of introduction points along with
+the service's full public key. It anonymously publishes this descriptor
+to the directory servers, and other people anonymously fetch it from the
+directory servers when they're trying to access your service.
+<p>Try it now: paste the contents of the hostname file into your web
+browser. If it works, you'll get the google frontpage, but the URL in your
+browser's window will be your hidden service hostname. If it doesn't work,
+look in your logs for some hints, and keep playing with it until it works.
+<hr />
+<a name="two"></a>
+<h3>Step Two: Now install a web server locally</h3>
+<p>Now that you've got hidden services working on Tor, you need to
+set up your web server locally. Setting up a web server is tricky,
+so we're just going to go over a few basics here. If you get stuck
+or want to do more, find a friend who can help you.
+<p>If you're on Unix or OS X and you're comfortable with
+the command-line, by far the best way to go is to install <a
+href="http://www.acme.com/software/thttpd/">thttpd</a>. Just grab the
+latest tarball, untar it (it will create its own directory), and run
+./configure &amp;&amp; make. Then mkdir hidserv, cd hidserv, and run
+"../thttpd -p 5222 -h localhost". Wham, you're running a webserver on
+port 5222. You can put files to serve in the hidserv directory.
+<p>If you're on Windows, ...
+<hr />
+<a name="three"></a>
+<h3>Step Three: Connect your web server to your hidden service</h3>
+<p>This part is very simple. Open up your torrc again, and change the
+HiddenServicePort line from "www.google.com:80" to "localhost:5222".
+Then restart Tor. Make sure that it's working by reloading your hidden
+service hostname in your browser.
 <hr />

More information about the tor-commits mailing list