wiki/src/doc/first_steps/persistence/upgrade.mdwn

   1 [[!meta title="Upgrade to more secure persistence settings"]]
   2
   3 Tails 0.21 introduces a more secure access control over the persistent
   4 volume settings. This also means that before Tails 0.21, an attacker who
   5 could run an exploit from inside your Tails session could corrupt the
   6 persistent volume settings. By doing this, an attacker could possibly
   7 gain persistent administrator rights or install malicious software.
   8
   9 For more technical details about the security of the persistent volume,
  10 read our [[design document|contribute/design/persistence#security]].
  11
  12 [[!toc]]
  13
  14 <div id="automatic_upgrade">
  15
  16 Automatic upgrade
  17 =================
  18
  19 We designed a migration mechanism that allows, in most cases, to upgrade
  20 automatically to those more secure persistent volume settings. To do this
  21 upgrade, once and for all:
  22
  23 1. **Start Tails 0.21**.
  24 2. **Enable persistence** without the read-only option. Activating the read-only
  25    option prevents Tails from starting correctly until the upgrade is made.
  26 3. If the upgrade is successful, Tails starts as usual and no notification
  27    appears.
  28
  29 But this automatic upgrade might not be sufficient in some cases.
  30
  31 a. **If you skipped the upgrade to Tails 0.21 and upgraded directly
  32    to Tails 0.22 or later**, then follow the instructions to [[manually copy
  33    your persistent data to a new device|copy]].
  34    For security reasons the automatic upgrade is not available in Tails 0.22 or
  35    later.
  36
  37 b. **If you have custom persistence settings or use
  38    [[additional software packages|configure#additional_software]]**, the
  39    corresponding settings are not upgraded automatically.
  40
  41    A notification should appear when starting Tails that indicates which
  42    persistence settings are temporarily disabled. In that case, follow
  43    the instructions to [[enable again your custom persistence
  44    settings|upgrade#custom_settings]].
  45
  46    <div class="caution">
  47
  48      If you have custom persistence settings or use additional software
  49      but no notification appear on the desktop, then your Tails system
  50      might be corrupted. In that case, follow the instructions to [[manually copy
  51      your persistent data to a new device|copy]].
  52
  53    </div>
  54
  55 c. **If you have good reasons to think that your persistence settings
  56    are corrupted** or if you want to be extra careful, then follow the
  57    instructions to [[manually copy your persistent data to a new
  58    device|copy]].
  59
  60 <div id="custom_settings">
  61
  62 Enabling again your custom persistence settings
  63 ===============================================
  64
  65 Custom persistence settings and additional software are disabled during
  66 the automatic upgrade because, there is technically a possibility for
  67 these files to be corrupted.
  68
  69 These instructions explain how to verify the content of these files and
  70 enable again your custom persistence settings.
  71
  72 1. Start Tails and set an
  73    [[administration password|startup_options/administration_password]].
  74
  75 1. Choose
  76    <span class="menuchoice">
  77      <span class="guimenu">Applications</span>&nbsp;▸
  78      <span class="guisubmenu">Accessories</span>&nbsp;▸
  79      <span class="guimenuitem">Root Terminal</span>
  80    </span>
  81    to open a terminal with administration rights.
  82
  83 1. Execute the <span class="code">nautilus</span> command to open the
  84    file browser.
  85
  86 1. In the file browser navigate to
  87    <span class="filename">/live/persistence/TailsData_unlocked</span>.
  88
  89 <span class="filename">live-persistence.conf.old</span>
  90 -------------------------------------------------------
  91
  92 If there is a file named
  93 <span class="filename">live-persistence.conf.old</span> in the
  94 <span class="filename">TailsData_unlocked</span> folder, then some of your
  95 persistence settings need to be enabled manually.
  96
  97 1. In the file browser, right-click on the
  98    <span class="filename">live-persistence.conf.old</span> file and open
  99    it by choosing
 100    <span class="guilabel">Open with Other Application...</span>
 101    and then <span class="guilabel">gedit</span>.
 102
 103 1. Switch back to the file browser, right-click on the
 104    <span class="filename">persistence.conf</span>
 105    file and choose
 106    <span class="guilabel">Open with Other Application...</span> and then
 107    <span class="guilabel">gedit</span> to open it in a new tab in
 108    <span class="application">gedit</span>.
 109
 110 1. Switch between the two tabs corresponding to those files in
 111    <span class="application">gedit</span> and compare their content.
 112    Copy from <span class="filename">live-persistence.conf.old</span> to
 113    <span class="filename">persistence.conf</span> the lines
 114    corresponding to your custom settings that have not been upgraded
 115    automatically.
 116
 117 Those missing lines should correspond to your custom directories or
 118 other custom persistence settings.
 119
 120 **If you detect unexpected lines in
 121 <span class="filename">live-persistence.conf.old</span>** that do not
 122 correspond to any change that you have made, they might have been
 123 introduced by an attacker. In this case, do the following:
 124
 125 1. [[Report a bug using
 126    <span class="application">WhisperBack</span>|bug_reporting]] and
 127    explain which are the lines that look suspicious to you.
 128
 129 1. Keep that Tails device without modifying it in order to analyse it
 130    later if needed.
 131
 132 1. Follow the instructions to [[manually copy your persistent data to a
 133    new device|copy]].
 134
 135 **If you do not detect any suspicious line**, close
 136 <span class="application">gedit</span> and delete the
 137 <span class="filename">live-persistence.conf.old</span> file using the
 138 file browser.
 139
 140 <span class="filename">live-additional-software.conf.disabled</span>
 141 --------------------------------------------------------------------
 142
 143 If there is a file named
 144 <span class="filename">live-additional-software.conf.disabled</span> in
 145 the <span class="filename">TailsData_unlocked</span> folder, then your
 146 [[additional software|configure#additional_software]] need to be enabled
 147 manually.
 148
 149 1. In the file browser, right-click on the
 150    <span class="filename">live-additional-software.conf.disabled</span>
 151    file and open it by choosing
 152    <span class="guilabel">Open with Other Application...</span> and then
 153    <span class="guilabel">gedit</span>.
 154
 155 1. Right-click on the
 156    <span class="filename">live-additional-software.conf</span> file and
 157    choose <span class="guilabel">Open with Other Application...</span>
 158    and then <span class="guilabel">gedit</span> to open it in a new tab
 159    in <span class="application">gedit</span>.
 160
 161 1. Copy from
 162    <span class="filename">live-additional-software.conf.disabled</span>
 163    to <span class="filename">live-additional-software.conf</span> the
 164    lines corresponding to your additional software.
 165
 166 **If you detect unexpected lines in
 167 <span class="filename">live-additional-software.conf.disabled</span>**
 168 that do not correspond to any additional software added by you, they
 169 might have been introduced by an attacker. In this case, do the
 170 following:
 171
 172 1. [[Report a bug using
 173    <span class="application">WhisperBack</span>|bug_reporting]] and
 174    explain which are the lines that look suspicious to you.
 175
 176 1. Keep that Tails device without modifying it in order to analyse it
 177    later if needed.
 178
 179 1. Follow the instructions to [[manually copy your persistent data to a
 180    new device|copy]].
 181
 182 **If you do not detect any suspicious line**, close
 183 <span class="application">gedit</span> and delete the
 184 <span class="filename">live-additional-software.conf.disabled</span>
 185 file using the file browser.