aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 1343b25f4fc19ff66a30530fb4762e24f8fdfb85 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

### DISCLAIMER

Multiple layers of scary disclaimer! Oh my!

   !!! This repo is hackish, under development and will probably not even build
   !!! or "work"!

   !!! torouter is not on official Tor Foundation project!

   !!! the torouter CONCEPT has not been clarified or reviewed!

   !!! this torouter IMPLEMENTATION is undocumented, unspeced, and full of
   !!! bugs. do not use it!

   !!! torouter has not (yet) been developed by a security expert! 

   !!! torouter will not (yet) protect your anonymity in any way!

   !!! this work is unlicensed and contains licensed material!

### Build Requirements

Only tested on a debian wheezy host with many development packages already
installed; YMMV.

Install live-build and qemu:

    sudo apt-get install qemu-user-static qemu-utils debootstrap live-build

You need a recent version of live-build because of a secring.gpg-related error
(see http://lists.debian.org/debian-live/2012/07/msg00122.html); download the
sid package (from http://packages.debian.org/sid/live-build) and install:
(or, from http://live.debian.net/debian/ ?)

    sudo dpkg -i live-build_3.0~a67-1_all.deb

You might also want the Debian Live manuals:

    sudo apt-get install live-manual-html

### Build an Image

Warning: aggressive caching is in place, which means resulting images may have
stale packages. Use `lb clean` to clear caches.

Once the above build requirements are satisfied:

    lb clean --purge
    lb clean --binary
    lb clean
    lb config
    lb build

### Develop

Basic configuration options are in ./auto/config