configure.mdwn 8.63 KB
Newer Older
1
[[!meta title="Create & Configure the Persistent Volume"]]
2 3 4

[[!inline pages="doc/first_steps/persistence.caution" raw="yes"]]

Tails developers's avatar
Tails developers committed
5 6
[[!toc levels=2]]

7 8
Start the Persistent Volume Assistant
=====================================
9

10
To start the persistent volume assistant, choose
11 12 13 14 15
<span class="menuchoice">
  <span class="guimenu">Applications</span>&nbsp;▸
  <span class="guisubmenu">Tails</span>&nbsp;▸
  <span class="guimenuitem">Configure persistent storage</span></span>.

Tails developers's avatar
Tails developers committed
16 17 18 19 20 21
<div class="note">
The error message <span class="emphasis">Error, Persistence partition is not
unlocked.</span> means that the persistent volume was not enabled from
<span class="application">Tails greeter</span>. So you can not configure it
but you can delete it and create a new one.
</div>
22

23 24
Creating the Persistent Volume
==============================
25 26

When run for the first time, or after [[deleting the persistent
27
volume|delete]], the assistant proposes to create a new persistent volume on
28 29
the USB stick from which Tails is running.

30
1. The persistent volume is an encrypted partition protected by a passphrase.
31 32 33 34 35 36 37 38 39 40
Specify a passphrase of your choice in both the
<span class="guilabel">Passphrase</span> and <span class="guilabel">Verify
Passphrase</span> text boxes.

2. Click on the <span class="guilabel">Create</span> button.

3. Wait for the creation to finish.

<div class="bug">
<strong>If the creation is interrupted before it finishes</strong>, you may not
Tails developers's avatar
Tails developers committed
41
be able to start Tails from this USB stick any more. This can happen if you
42
close the window of the wizard or unplug the USB stick during the creation of
43
the persistent volume. [[Delete|first_steps/usb_reset]] and
44
[[reinstall|first_steps/usb_installation]] Tails to fix this issue.
45 46
</div>

47 48
Persistent Volume Features
==========================
49

50
When run from a USB stick that already has a persistent volume, the assistant
51
shows a list of the possible persistent features. Each feature corresponds to a
52
set a files to be saved in the persistent volume.
53 54 55 56 57 58 59

<div class="note">
<strong>Restart Tails to apply the changes</strong> after selecting or
unselecting one or several features.
</div>

<div class="bug">
Tails developers's avatar
Tails developers committed
60 61
If you unselect a feature that used to be activated, it will be
deactivated after restarting Tails but the corresponding files will
62
remain on the persistent volume.
63 64
</div>

65 66
<a id="personal_data"></a>

67 68
<div class="icon">
<div class="image"><img src="../stock_folder.png"/></div>
Tails developers's avatar
Tails developers committed
69
<div class="text"><h2>Personal Data</h2></div>
70 71 72 73 74 75 76 77 78
</div>

When this feature is activated, you can save your personal files and working
documents in the <span class="filename">Persistent</span> folder.

To open the <span class="filename">Persistent</span> folder, choose
<span class="menuchoice">
  <span class="guimenu">Places</span>&nbsp;▸
  <span class="guimenuitem">Home Folder</span></span>, and open the <span
79
  class="guilabel">Persistent</span> folder.
80

81 82
<a id="gnupg"></a>

83 84
<div class="icon">
<div class="image"><img src="../seahorse-key.png"/></div>
Tails developers's avatar
Tails developers committed
85
<div class="text"><h2>GnuPG</h2></div>
86 87 88
</div>

When this feature is activated, the OpenPGP keys that you create or import are
89
saved in the persistent volume.
90 91

<div class="caution">
Tails developers's avatar
Tails developers committed
92 93 94
If you manually edit or overwrite the
<span class="filename">~/.gnupg/gpg.conf</span> configuration file
you may lessen your anonymity,
95 96 97
weaken the encryption defaults or render GnuPG unusable.
</div>

98 99
<a id="ssh_client"></a>

100 101
<div class="icon">
<div class="image"><img src="../seahorse-key-ssh.png"/></div>
Tails developers's avatar
Tails developers committed
102
<div class="text"><h2>SSH Client</h2></div>
103 104 105
</div>
    
When this feature is activated, all the files related to the secure-shell client
106
are saved in the persistent volume:
107 108 109 110 111 112

  - The SSH keys that you create or import
  - The public keys of the hosts you connect to
  - The SSH configuration file in <span class="filename">~/.ssh/config</span> 

<div class="caution">
Tails developers's avatar
Tails developers committed
113 114 115 116
If you manually edit the <span class="filename">~/.ssh/config</span>
configuration file, make sure not to overwrite the
default configuration from the
<span class="filename">/etc/ssh/ssh_config</span> file. Otherwise, you may weaken the
117 118 119
encryption defaults or render SSH unusable.
</div>

120 121
<a id="pidgin"></a>

122 123
<div class="icon">
<div class="image"><img src="../pidgin.png"/></div>
Tails developers's avatar
Tails developers committed
124
<div class="text"><h2>Pidgin</h2></div>
125 126 127
</div>

When this feature is activated, all the configuration files of the
128 129
<span class="application">Pidgin</span> Internet messenger are saved in the
persistent volume:
130 131 132

  - The configuration of your accounts, buddies and chats.
  - Your OTR encryption keys and keyring.
Tails developers's avatar
Tails developers committed
133
  - The content of the discussions is not saved unless you configure
134 135 136 137 138
    <span class="application">Pidgin</span> to do so.

All the configuration options are available from the graphical interface. There
is no need to manually edit or overwrite the configuration files.

139 140
<a id="claws_mail"></a>

141 142
<div class="icon">
<div class="image"><img src="../claws-mail.png"/></div>
Tails developers's avatar
Tails developers committed
143
<div class="text"><h2>Claws Mail</h2></div>
144 145 146
</div>

When this feature is activated, the configuration and emails stored locally by
147 148
the <span class="application">Claws Mail</span> email client are saved in the
persistent volume.
149 150 151 152

All the configuration options are available from the graphical interface. There
is no need to manually edit or overwrite the configuration files.

153 154
<a id="gnome_keyring"></a>

155 156
<div class="icon">
<div class="image"><img src="../seahorse-key-personal.png"/></div>
Tails developers's avatar
Tails developers committed
157
<div class="text"><h2>GNOME Keyring</h2></div>
158 159 160
</div>

When this feature is activated, the secrets of
161 162
<span class="application">GNOME Keyring</span> are saved in the persistent
volume.
163 164 165 166 167 168

GNOME Keyring is a collection of components in GNOME that store secrets,
passwords, keys, certificates and make them available to applications.
For more information about <span class="application">GNOME Keyring</span> see
the [official documentation](http://live.gnome.org/GnomeKeyring).

169 170
<a id="apt_packages"></a>

171 172
<div class="icon">
<div class="image"><img src="../synaptic.png"/></div>
Tails developers's avatar
Tails developers committed
173
<div class="text"><h2>APT Packages</h2></div>
174 175 176 177
</div>

When this feature is activated, the packages that you install using the
<span class="application">Synaptic</span> package manager or the
178
<span class="command">apt-get</span> command are saved in the persistent volume.
179

180 181 182
If you install additional programs, this feature allows you to download them
once and reinstall them during future working sessions, even offline.
Note that those packages are not automatically installed when restarting Tails.
183 184 185 186

If you activate this feature, it is recommended to activate the
<span class="guilabel">APT Lists</span> feature as well.

187 188
<a id="apt_lists"></a>

189 190
<div class="icon">
<div class="image"><img src="../synaptic.png"/></div>
Tails developers's avatar
Tails developers committed
191
<div class="text"><h2>APT Lists</h2></div>
192 193 194
</div>

When this feature is activated, the lists of all the software packages available
195
for installation are saved in the persistent volume.
196 197 198 199 200 201 202

Those so called <span class="emphasis">APT lists</span> correspond to the files
downloaded while doing
<span class="guilabel">Reload</span> from the
<span class="application">Synaptic</span> package manager or issuing the
<span class="command">apt-get update</span> command.

203 204 205 206
The <span class="emphasis">APT lists</span> are needed to install additional
programs or explore the list of available software packages. This feature allows
you to reuse them during future working sessions, even offline.

207 208
<a id="dotfiles"></a>

209 210
<div class="icon">
<div class="image"><img src="../preferences-desktop.png"/></div>
Tails developers's avatar
Tails developers committed
211
<div class="text"><h2>Dotfiles</h2></div>
212 213
</div>

214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229
When this feature is activated, all the files in the <span
class="filename">/live/persistent/XXX_unlocked/dotfiles</span> folder
are linked in the <span class="filename">Home Folder</span> (files in
subfolders of <span class="filename">dotfiles</span> are also linked
in the corresponding subfolder of your <span class="filename">Home
Folder</span>). The `XXX` in the above should be something like `sdb2`
but since there will only ever be one folder in <span
class="filename">/live/persistent</span> there should be little risk
for confusion.

This option is useful if you want to make some specific files
persistent, but not the folders they are stored in. A fine example are
the so called "dotfiles" (and hence the name of this feature), the
hidden configuration files in the root of your home directory, like
<span class="filename">~/.git</span> and <span
class="filename">~/.bashrc</span>.
230

231 232
<a id="custom_directory"></a>

233 234 235 236 237 238 239 240 241 242
Custom directory
----------------

With this feature you can specify other folders of your choice to be saved in
the persistent volume.

If for example you want to create and make persistent an
<span class="filename">Images</span> folder in the
<span class="filename">Home Folder</span> you can specify
<span class="filename">/home/amnesia/Images</span> as a custom directory.