upgrade.mdwn 6.33 KB
Newer Older
1
2
3
4
5
6
7
8
[[!meta title="Upgrading a Tails USB stick"]]

Tails includes an automatic mechanism to upgrade a USB stick to
a newer version. In some cases, it is impossible to do an **automatic upgrade**
and you might have to do a **manual upgrade**. This page describes both techniques.

<div class="note">

sajolida's avatar
Clarify  
sajolida committed
9
10
<p>Your persistent storage will be preserved by both automatic and
manual upgrades.</p>
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

</div>

If you use Tails from a DVD, you need to [[burn a new DVD|install/dvd]].

[[!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 USB stick. The upgrades are checked for and downloaded
through Tor.

The advantages of this technique are the following:

  - You only need a single Tails USB stick. 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 USB image.
  - The upgrade mechanism includes cryptographic verification of the upgrade.
    You don't have to verify the USB image yourself anymore.

Requirements:

  - A Tails USB stick.
  - An Internet connection.

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

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

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

<div class="note">

sajolida's avatar
sajolida committed
52
53
54
<p>If you missed an upgrade, each upgrade will be installed one after the
other.</p>

55
56
57
<p>For example, if you have a Tails 4.1 and the current version
is 4.5, then the upgrade to 4.3 will be installed, and after you restart Tails, the
upgrade to 4.5 will be installed.</p>
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

</div>

<div class="tip">

<p>If you cannot upgrade at startup (for example if you have no network
connection by then), you can start <span class="application">Tails
Upgrader</span> later by opening a terminal and executing the following
command:</p>

<pre>tails-upgrade-frontend-wrapper</pre>

</div>

<div class="tip">

<p>We recommend you read the [[release notes|release_notes]] for the latest version. They document all the changes in this new version:</p>

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

</div>

84
85
86
87
Troubleshooting
---------------

If an error occurs during the upgrade, the assistant proposes you to read one of the following
88
89
90
91
92
93
94
95
96
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]]

97
98
If your Tails USB stick fails to start after an automatic upgrade, see
below how to do a manual upgrade.
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
<a name="manual"></a>

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

<div class="tip">

<p>We recommend you read the [[release notes|release_notes]] for the latest version. They document all the changes in this new version:</p>

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

</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 USB stick, etc.).
  - You want to upgrade from another Tails USB stick which already has a newer
    version installed, for example when working offline.
  - The automatic upgrade failed and you need to repair a Tails USB stick.

After connecting to Tor, a dialog informs you if you have to
upgrade your USB stick using <span class="application">Tails Installer</span>
to a newer version of Tails.

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

<div class="tip">

To know your version of 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>
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163

To do a manual upgrade, you can either:

- [[Upgrade by cloning from another Tails|doc/upgrade/#clone]] (below)
- [[Download and upgrade|doc/upgrade/#download]] (below)
- [[Burn a new Tails DVD|install/dvd-download]]
- [[Upgrade your virtual machine|install/vm-download]]

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

### Upgrade by cloning from another Tails

If you know someone you trust who already did the upgrade, you can
upgrade your Tails by cloning from their Tails.

You need:

- Your Tails USB stick
- Another up-to-date Tails (USB stick or DVD)
- ¼ hour to upgrade

sajolida's avatar
sajolida committed
164
165
166
See our instructions on how to do a manual upgrade by:

- [[Cloning from another Tails|upgrade/clone-overview]]
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183

<a id="download"></a>

### Download and upgrade

You need:

- Your Tails USB stick
- Another empty USB stick <small>(at least 8 GB)</small>&nbsp;[[!toggle id="why_extra" text="Why?"]]
- 1 hour to download Tails (<small class="remove-extra-space">[[!inline pages="inc/stable_amd64_iso_size" raw="yes" sort="age"]]</small>)
- ½ hour to upgrade

[[!toggleable id="why_extra" text="""
[[!toggle id="why_extra" text="X"]]
[[!inline pages="install/inc/router/why_extra.inline" raw="yes" sort="age"]]
"""]]

sajolida's avatar
sajolida committed
184
185
186
187
See our instructions on how to do a manual upgrade by:

- [[Downloading and upgrading from your Tails|upgrade/tails-overview]] (more secure)
- [[Downloading and upgrading from Windows|upgrade/win-overview]] (more convenient)
sajolida's avatar
sajolida committed
188
- [[Downloading and upgrading from macOS|upgrade/mac-overview]] (more convenient)
sajolida's avatar
sajolida committed
189
- [[Downloading and upgrading from Linux|upgrade/linux-overview]] (more convenient)
sajolida's avatar
sajolida committed
190
191
192
193
194
195
196
197

<div class="caution">

<p>Downloading and upgrading from Windows might be less secure if your
Windows is compromised but it might be more convenient and faster to
download.</p>

</div>