wiki/src/contribute/customize.mdwn

   1 This page documents a bit how to [[contribute/build]] a custom system
   2 based on Tails.
   3
   4 <div class="caution">
   5
   6 <strong>The resulting system will effectively be a fork of
   7 Tails, that only you can support: do not expect any help from us about
   8 it.<br />
   9 Please consider [[having your changes merged|contribute/how/code]]
  10 into Tails instead.
  11 </strong>
  12 </div>
  13
  14
  15 [[!toc levels=2]]
  16
  17 # Settings specific to Tails
  18
  19 The settings that can be customized can be found in `config/amnesia`;
  20 e.g. desktop environment.
  21
  22 You'd better never directly edit this file: rather put your custom
  23 variable assignments in a new `config/amnesia.local` file. The values
  24 found in the `.local` file will override the ones from the
  25 upstream one.
  26
  27 These configuration files are actually shell scripts, and are sourced
  28 by various other scripts.
  29
  30 # Debian Live settings
  31
  32 The Amnesic Incognito Live System is based on Debian Live.
  33 Nearly everything can thus be customized. To learn how to do so, refer
  34 to the Debian Live [manual](http://live.debian.net/manual/oldstable/html/live-manual.en.html),
  35 [website](http://debian-live.alioth.debian.org/) and
  36 [wiki](https://wiki.debian.org/DebianLive/).
  37
  38 # $HOME
  39
  40 Tails default user's `$HOME` directory is created at runtime from
  41 `/etc/skel/`. One may want to build an image including a modified
  42 version of it. There are multiple ways to do so:
  43
  44 1. edit the content of `config/chroot_local-includes/etc/skel/`
  45 2. dropping shell scripts in `config/chroot_local-hooks/` or
  46    `config/chroot_local-includes/lib/live/config/`
  47    to modify `/home/amnesia` in a program-driven way
  48    (`gconftool`, etc.)