wiki/src/doc/first_steps/upgrade.mdwn

   1 [[!meta title="Upgrading a Tails USB stick or SD card"]]
   2
   3 Tails includes an automatic mechanism to upgrade a USB stick or a SD card to
   4 newer versions. When it is not possible to do this **automatic upgrade**, it is
   5 possible to do a **manual upgrade**. This page describes both techniques.
   6
   7 <div class="caution">
   8
   9 Our upgrades always fix important security issues so it is important to do them
  10 as soon as possible.
  11
  12 </div>
  13
  14 Both techniques only work if the upgraded device, USB stick or SD card, was
  15 installed using <span class="application">Tails Installer</span>. **The
  16 persistent storage on the device will be preserved.**
  17
  18 <div class="note">
  19
  20 If you use Tails from a DVD or if your Tails device was not installed using
  21 <span class="application">Tails Installer</span>, it is not possible to upgrade
  22 and you need to follow our [[installation instructions|download#media]] again
  23 with the new ISO image.
  24
  25 </div>
  26
  27 [[!toc levels=2]]
  28
  29 <a name="automatic"></a>
  30
  31 Automatic upgrade using <span class="application">Tails Upgrader</span>
  32 =======================================================================
  33
  34 After starting Tails and connecting to Tor, <span class="application">Tails
  35 Upgrader</span> automatically checks if upgrades are available and then
  36 proposes you to upgrade your device. The upgrades are checked for and downloaded
  37 through Tor.
  38
  39 The advantages of this technique are the following:
  40
  41   - You only need a single Tails device. The upgrade is done on the fly from a
  42     running Tails. After upgrading, you can restart and use the new version.
  43   - The upgrade is much smaller to download than a full ISO image.
  44   - The upgrade mechanism includes cryptographic verification of the upgrade.
  45     You don't have to verify the ISO image yourself anymore.
  46
  47 Requirements:
  48
  49   - A Tails device, USB stick or SD card, installed using
  50     <span class="application">Tails Installer</span>.
  51   - An Internet connection.
  52
  53 After connecting to Tor, if an upgrade is available, a dialog box appears and
  54 proposes you to upgrade your device.
  55
  56 [[!img upgrader.png link=no]]
  57
  58 <div class="note">
  59
  60 <ul>
  61 <li>It is recommended to close all the open applications during the
  62 upgrade.</li>
  63 <li>Downloading the upgrade might take a long time, from several minutes to a
  64 few hours.</li>
  65 <li>The networking will be disabled after downloading the upgrade.</li>
  66 </ul>
  67
  68 </div>
  69
  70 If you decide to do the upgrade, click on <span
  71 class="guilabel">Upgrade now</span>,
  72 and follow the assistant through the upgrade process.
  73
  74 <div class="tip">
  75
  76 [[!inline pages="doc/first_steps/upgrade.release_notes" raw="yes"]]
  77
  78 </div>
  79
  80 If an error occurs, the assistant proposes you to read one of the following
  81 pages:
  82
  83   - If an error occurs while checking for available upgrades:<br/>
  84     [[file:///usr/share/doc/tails/website/doc/upgrade/error/check.en.html|upgrade/error/check]]
  85   - If an error occurs while download the upgrade:<br/>
  86     [[file:///usr/share/doc/tails/website/doc/upgrade/error/download.en.html|upgrade/error/download]]
  87   - If an error occurs while installing the upgrade:<br/>
  88     [[file:///usr/share/doc/tails/website/doc/upgrade/error/install.en.html|upgrade/error/install]]
  89
  90 <a name="manual"></a>
  91
  92 Manual upgrade using <span class="application">Tails Installer</span>
  93 =====================================================================
  94
  95 <div class="tip">
  96
  97 [[!inline pages="doc/first_steps/upgrade.release_notes" raw="yes"]]
  98
  99 They might also contain <strong>special instructions for upgrading</strong>.
 100
 101 </div>
 102
 103 <div class="note">
 104
 105 If you use Tails from a DVD or if your Tails device was not installed using
 106 <span class="application">Tails Installer</span>, it is not possible to upgrade
 107 and you need to follow our [[installation instructions|download#media]] again
 108 with the new ISO image.
 109
 110 </div>
 111
 112 It might not always be possible to do an automatic upgrade as described above.
 113 For example, when:
 114
 115   - No automatic upgrade is available from our website for this version.
 116   - The automatic upgrade is impossible for technical reasons (not enough
 117     memory, not enough free space on the device, etc.).
 118   - You want to upgrade from another Tails device which already has a newer
 119     version installed, for example when working offline.
 120   - The automatic upgrade failed and you need to repair a Tails device.
 121
 122 In that case, <span class="application">Tails Installer</span> allows you to
 123 manually upgrade a USB stick or SD card to a newer version of Tails. Using <span
 124 class="application">Tails Installer</span> you can either:
 125
 126   - [[Upgrade by cloning from another device|upgrade#clone]] which already
 127     runs a newer version of Tails.
 128   - [[Upgrade from an ISO image|upgrade#from_iso]] of a newer version of
 129     Tails.
 130
 131 <div class="note">
 132
 133 Like for installing, you need to start <span class="application">Tails
 134 Installer</span> from another media than the device that you want to upgrade.
 135
 136 </div>
 137
 138 <div class="tip">
 139
 140 To know the version of a running Tails, choose
 141 <span class="menuchoice">
 142   <span class="guimenu">Applications</span>&nbsp;▸
 143   <span class="guisubmenu">Tails</span>&nbsp;▸
 144   <span class="guimenuitem">About Tails</span>
 145 </span>
 146
 147 </div>
 148
 149 <a id="clone"></a>
 150
 151 Clone & Upgrade
 152 ---------------
 153
 154 1. Start Tails from the DVD, USB stick, or SD card, that you want to clone from.
 155
 156 2. Choose
 157    <span class="menuchoice">
 158      <span class="guimenu">Applications</span>&nbsp;▸
 159      <span class="guisubmenu">Tails</span>&nbsp;▸
 160      <span class="guimenuitem">Tails Installer</span>
 161    </span>
 162    to start <span class="application">Tails Installer</span>.
 163
 164 3. Choose <span class="guilabel">Clone & Upgrade</span>.
 165
 166 4. Plug the device that you want to upgrade.
 167
 168    A new device, which corresponds to the USB stick or SD card, appears in the
 169    <span class="guilabel">Target Device</span> drop-down list.
 170
 171 5. Choose the device from the <span class="guilabel">Target Device</span>
 172    drop-down list.
 173
 174 6. To start the upgrade, click on the <span class="button">Install
 175    Tails</span> button.
 176
 177 7. Read the warning message in the pop-up window. Click on the <span
 178    class="button">Yes</span> button to confirm.
 179
 180 <a id="from_iso"></a>
 181
 182 Upgrade from ISO
 183 ----------------
 184
 185 1. Start Tails from another DVD, USB stick, or SD card, than the device that you
 186    want to upgrade.
 187
 188 2. Choose
 189    <span class="menuchoice">
 190      <span class="guimenu">Applications</span>&nbsp;▸
 191      <span class="guisubmenu">Tails</span>&nbsp;▸
 192      <span class="guimenuitem">Tails Installer</span>
 193    </span>
 194    to start <span class="application">Tails Installer</span>.
 195
 196 3. Choose <span class="guilabel">Upgrade from ISO</span>.
 197
 198 4. Plug the device that you want to upgrade.
 199
 200    A new device, which corresponds to the USB stick or SD card, appears in the
 201    <span class="guilabel">Target Device</span> drop-down list.
 202
 203 5. Choose the device from the <span class="guilabel">Target Device</span>
 204    drop-down list.
 205
 206 6. Click on the <span class="guilabel">Browse</span> button to specify the
 207    location of the ISO image.
 208
 209    If the ISO image is saved on another media, plug it if necessary and click on
 210    the corresponding device in the <span class="guilabel">Places</span> column.
 211
 212    <div class="tip">
 213
 214    If the ISO image is stored in a persistent volume, the corresponding device
 215    appears first as <span class="guilabel">Encrypted</span>. Click on the device
 216    and, in the popup window, enter the passphrase to unlock it.
 217
 218    </div>
 219
 220 7. Read the warning message in the pop-up window. Click on the <span
 221    class="button">Yes</span> button to confirm.