summaryrefslogtreecommitdiffstats
path: root/wiki/src/doc/first_steps/upgrade.mdwn
blob: f64ee63a5445750a6b0edc7d0a7ce43738652d7f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
[[!meta title="Upgrading a Tails USB stick or SD card"]]

Tails includes an automatic mechanism to upgrade a USB stick or a SD card to
newer versions. When it is not possible to do this **automatic upgrade**, it is
possible to do a **manual upgrade**. This page describes both techniques.

<div class="caution">

Our upgrades always fix important security issues so it is important to do them
as soon as possible.

</div>

Both techniques only work if the upgraded device, USB stick or SD card, was
installed using <span class="application">Tails Installer</span>. **The
persistent storage on the device will be preserved.**

<div class="note">

If you use Tails from a DVD or if your Tails device was not installed using
<span class="application">Tails Installer</span>, it is not possible to upgrade
and you need to follow our [[installation instructions|download#media]] again
with the new ISO image.

</div>

[[!toc levels=2]]

<a name="automatic"></a>

Automatic upgrade using <span class="application">Tails Upgrader</span>
=======================================================================

After starting Tails and connecting to Tor, <span class="application">Tails
Upgrader</span> automatically checks if upgrades are available and then
proposes you to upgrade your device. The upgrades are checked for and downloaded
through Tor.

The advantages of this technique are the following:

  - You only need a single Tails device. The upgrade is done on the fly from a
    running Tails. After upgrading, you can restart and use the new version.
  - The upgrade is much smaller to download than a full ISO image.
  - The upgrade mechanism includes cryptographic verification of the upgrade.
    You don't have to verify the ISO image yourself anymore.

Requirements:

  - A Tails device, USB stick or SD card, installed using
    <span class="application">Tails Installer</span>.
  - An Internet connection.

After connecting to Tor, if an upgrade is available, a dialog box appears and
proposes you to upgrade your device.

[[!img upgrader.png link=no]]

<div class="note">

<ul>
<li>It is recommended to close all the open applications during the
upgrade.</li>
<li>Downloading the upgrade might take a long time, from several minutes to a
few hours.</li>
<li>The networking will be disabled after downloading the upgrade.</li>
</ul>

</div>

If you decide to do the upgrade, click on <span
class="guilabel">Upgrade now</span>,
and follow the assistant through the upgrade process.

If an error occurs, the assistant proposes you to read one of the following
pages:

  - If an error occurs while checking for available upgrades:<br/>
    [[file:///usr/share/doc/tails/website/doc/upgrade/error/check.en.html|upgrade/error/check]]
  - If an error occurs while download the upgrade:<br/>
    [[file:///usr/share/doc/tails/website/doc/upgrade/error/download.en.html|upgrade/error/download]]
  - If an error occurs while installing the upgrade:<br/>
    [[file:///usr/share/doc/tails/website/doc/upgrade/error/install.en.html|upgrade/error/install]]

<a name="manual"></a>

Manual upgrade using <span class="application">Tails Installer</span>
=====================================================================

<div class="caution">

<!-- Note for translators: make sure that the translation of this string
integrates well with /inc/stable_i386_release_notes. -->

We recommend you to read the [[!inline pages="inc/stable_i386_release_notes" raw="yes"]]
for the latest version. They document all the changes in this new version:

<ul>
  <li>new features</li>
  <li>bugs that were solved</li>
  <li>known issues that have already been identified</li>
</ul>

They might also contain <strong>special instructions for upgrading</strong>.

</div>

<div class="note">

If you use Tails from a DVD or if your Tails device was not installed using
<span class="application">Tails Installer</span>, it is not possible to upgrade
and you need to follow our [[installation instructions|download#media]] again
with the new ISO image.

</div>

It might not always be possible to do an automatic upgrade as described above.
For example, when:

  - No automatic upgrade is available from our website for this version.
  - The automatic upgrade is impossible for technical reasons (not enough
    memory, not enough free space on the device, etc.).
  - You want to upgrade from another Tails device which already has a newer
    version installed, for example when working offline.
  - The automatic upgrade failed and you need to repair a Tails device.

In that case, <span class="application">Tails Installer</span> allows you to
manually upgrade a USB stick or SD card to a newer version of Tails. Using <span
class="application">Tails Installer</span> you can either:

  - [[Upgrade by cloning from another device|upgrade#clone]] which already
    runs a newer version of Tails.
  - [[Upgrade from an ISO image|upgrade#from_iso]] of a newer version of
    Tails.

<div class="note">

Like for installing, you need to start <span class="application">Tails
Installer</span> from another media than the device that you want to upgrade.

</div>

<div class="tip">

To know the version of a running Tails, choose
<span class="menuchoice">
  <span class="guimenu">Applications</span>&nbsp;▸
  <span class="guisubmenu">Tails</span>&nbsp;▸
  <span class="guimenuitem">About Tails</span>
</span>

</div>

<a id="clone"></a>

Clone & Upgrade
---------------

1. Start Tails from the DVD, USB stick, or SD card, that you want to clone from.

2. Choose
   <span class="menuchoice">
     <span class="guimenu">Applications</span>&nbsp;▸
     <span class="guisubmenu">Tails</span>&nbsp;▸
     <span class="guimenuitem">Tails Installer</span>
   </span>
   to start <span class="application">Tails Installer</span>.

3. Choose <span class="guilabel">Clone & Upgrade</span>.

4. Plug the device that you want to upgrade.

   A new device, which corresponds to the USB stick or SD card, appears in the
   <span class="guilabel">Target Device</span> drop-down list.

5. Choose the device from the <span class="guilabel">Target Device</span>
   drop-down list.

6. To start the upgrade, click on the <span class="button">Install
   Tails</span> button.

7. Read the warning message in the pop-up window. Click on the <span
   class="button">Yes</span> button to confirm.

<a id="from_iso"></a>

Upgrade from ISO
----------------

1. Start Tails from another DVD, USB stick, or SD card, than the device that you
   want to upgrade.

2. Choose
   <span class="menuchoice">
     <span class="guimenu">Applications</span>&nbsp;▸
     <span class="guisubmenu">Tails</span>&nbsp;▸
     <span class="guimenuitem">Tails Installer</span>
   </span>
   to start <span class="application">Tails Installer</span>.

3. Choose <span class="guilabel">Upgrade from ISO</span>.

4. Plug the device that you want to upgrade.

   A new device, which corresponds to the USB stick or SD card, appears in the
   <span class="guilabel">Target Device</span> drop-down list.

5. Choose the device from the <span class="guilabel">Target Device</span>
   drop-down list.

6. Click on the <span class="guilabel">Browse</span> button to specify the
   location of the ISO image.

   If the ISO image is saved on another media, plug it if necessary and click on
   the corresponding device in the <span class="guilabel">Places</span> column.

   <div class="tip">

   If the ISO image is stored in a persistent volume, the corresponding device
   appears first as <span class="guilabel">Encrypted</span>. Click on the device
   and, in the popup window, enter the passphrase to unlock it.

   </div>

7. Read the warning message in the pop-up window. Click on the <span
   class="button">Yes</span> button to confirm.