build.mdwn 2.41 KB
Newer Older
1
2
[[!meta title="Building a Tails image"]]

3
4
[[!toc levels=2]]

5
One may want to [[contribute/customize]] her image before building.
6
7

Every following command must be run as `root`, at the root of the
8
source directory one has [[downloaded|Git]].
9
10
11
12
13
14

For the impatient ones:

	$ git clone git://git.immerda.ch/amnesia.git
	$ cd amnesia
	$ sudo su
15
	# lb clean --all && lb config && lb build
16

17
Dependencies
amnesia's avatar
amnesia committed
18
============
19

20
* `live-build` from Debian Squeeze.
amnesia's avatar
amnesia committed
21
* `syslinux` >= 4.01, so that the built ISO images are
22
23
  converted to hybrid ones: they can be either a CD-ROM or a hard disk
  (USB disk, etc.).
24
25
* `eatmydata` (e.g. from Debian sid), `time` and `whois` (for
  /usr/bin/mkpasswd) packages.
Tails developers's avatar
Tails developers committed
26
* `ikiwiki` 3.20110431 or newer; released images are built using a
27
  patched ikiwiki is needed so that
28
29
30
  the static version of the wiki included in the image has correct
  links to the online wiki; see this [wishlist
  item](http://ikiwiki.info/todo/mirrorlist_with_per-mirror_usedirs_settings/)
31
32
  to get the custom ikiwiki branch. It is not critical to use it
  unless you prepare real releases.
33
34
35
* `apt-get install libyaml-perl libyaml-libyaml-perl po4a perlmagick
  libyaml-syck-perl` so that the wiki builds smoothly.
* `dpkg-dev`
36
37

Build process
amnesia's avatar
amnesia committed
38
=============
39

40
## Customize the build process if needed
41
42
43

If you need to set custom build settings that are specific to your
local environment, such as a custom Debian mirror or APT proxy, you
44
probably want to configure live-build a bit.
45

46
The most common customizations are documented on this wiki:
47

48
49
50
* to avoid compressing the SquashFS using XZ (efficient, but very
  slow), `export MKSQUASHFS_OPTIONS='-comp gzip'` in your
  build environment;
51
52
53
* [[using a custom Debian mirror to build Tails
  images|build/custom_mirror]];
* [[using squid-deb-proxy to build Tails images|build/squid-deb-proxy]].
54

55
56
More documentation about this can be found in the [Debian Live
Manual](http://live.debian.net/manual/en/).
57
58
59
60
61
62
63
64

## Initialize the Live system's configuration

Initialize the Live system's configuration with `lb config` in a
**clean** build tree. Most `lb config` options are supported, have a
look to the `lb_config(1)` manpage for details.

## Build the system
65

66
You can then use the standard live-build commands as root to build
67
the image (`lb build`) and to cleanup the build directory (`lb
68
clean`).
69
70
71
72
73

## More information

More documentation about the build process can be found in the [Debian
Live Manual](http://live.debian.net/manual/en/).