upgrade.mdwn 5.33 KB
Newer Older
Tails developers's avatar
Tails developers committed
1
[[!meta title="Upgrading a Tails USB stick"]]
Tails developers's avatar
Tails developers committed
2

sajolida's avatar
sajolida committed
3
4
5
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.
Tails developers's avatar
Tails developers committed
6

Tails developers's avatar
Tails developers committed
7
<div class="caution">
8

Tails developers's avatar
Tails developers committed
9
10
Our upgrades always fix important security issues so it is important to do them
as soon as possible.
Tails developers's avatar
Tails developers committed
11

Tails developers's avatar
Tails developers committed
12
13
</div>

Tails developers's avatar
Tails developers committed
14
Both techniques only work if the upgraded USB stick, was
Tails developers's avatar
Tails developers committed
15
installed using <span class="application">Tails Installer</span>. **The
16
persistent storage on the USB stick will be preserved.**
Tails developers's avatar
Tails developers committed
17
18
19

<div class="note">

20
21
<p>If you use Tails from a DVD, you need to [[burn a new DVD|install/dvd]].</p>

22
<p>If you use Tails from a USB stick installed from macOS using the
23
command line, you need to [[reinstall|install/mac/usb/overview]].</p>
Tails developers's avatar
Tails developers committed
24
25
26
27
28
29
30

</div>

[[!toc levels=2]]

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

Tails developers's avatar
Tails developers committed
31
32
Automatic upgrade using <span class="application">Tails Upgrader</span>
=======================================================================
Tails developers's avatar
Tails developers committed
33

Tails developers's avatar
Tails developers committed
34
35
After starting Tails and connecting to Tor, <span class="application">Tails
Upgrader</span> automatically checks if upgrades are available and then
36
proposes you to upgrade your USB stick. The upgrades are checked for and downloaded
37
through Tor.
Tails developers's avatar
Tails developers committed
38
39
40

The advantages of this technique are the following:

41
  - You only need a single Tails USB stick. The upgrade is done on the fly from a
Tails developers's avatar
Tails developers committed
42
43
44
45
46
47
48
    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:

Tails developers's avatar
Tails developers committed
49
  - A Tails USB stick, installed using
Tails developers's avatar
Tails developers committed
50
    <span class="application">Tails Installer</span>.
Tails developers's avatar
Tails developers committed
51
52
53
  - An Internet connection.

After connecting to Tor, if an upgrade is available, a dialog box appears and
54
proposes you to upgrade your USB stick.
Tails developers's avatar
Tails developers committed
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

[[!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>

70
71
If you decide to do the upgrade, click on <span
class="guilabel">Upgrade now</span>,
Tails developers's avatar
Tails developers committed
72
73
and follow the assistant through the upgrade process.

74
75
76
77
<div class="note">

If you missed an upgrade, each upgrade will be installed one after the
other. For exemple, if you have a Tails 1.3 and the current version
BitingBird's avatar
BitingBird committed
78
is 1.3.2, then the upgrade to 1.3.1 will be installed, and after you restart Tails, the
79
upgrade to 1.3.2 will be installed.
80
81
82

</div>

83
84
<div class="tip">

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

sajolida's avatar
sajolida committed
90
<pre>tails-upgrade-frontend-wrapper</pre>
91
92
93

</div>

94
95
<div class="tip">

sajolida's avatar
sajolida committed
96
<p>We recommend you read the [[release notes|release_notes]] for the latest version. They document all the changes in this new version:</p>
97
98
99
100
101
102
103
104
105
106

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

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

</div>
107

Tails developers's avatar
Tails developers committed
108
109
110
111
112
113
114
115
116
117
118
119
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>

Tails developers's avatar
Tails developers committed
120
121
Manual upgrade using <span class="application">Tails Installer</span>
=====================================================================
Tails developers's avatar
Tails developers committed
122

123
124
<div class="tip">

sajolida's avatar
sajolida committed
125
<p>We recommend you read the [[release notes|release_notes]] for the latest version. They document all the changes in this new version:</p>
126
127
128
129
130
131
132
133
134
135

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

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

</div>
136

Tails developers's avatar
Tails developers committed
137
138
139
140
141
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
142
143
    memory, not enough free space on the USB stick, etc.).
  - You want to upgrade from another Tails USB stick which already has a newer
Tails developers's avatar
Tails developers committed
144
    version installed, for example when working offline.
145
  - The automatic upgrade failed and you need to repair a Tails USB stick.
Tails developers's avatar
Tails developers committed
146

sajolida's avatar
sajolida committed
147
In this case, <span class="application">Tails Installer</span> allows you to
148
manually upgrade a USB stick to a newer version of Tails.
sajolida's avatar
sajolida committed
149
To do so, follow our [[manual upgrade instructions|/upgrade]].
sajolida's avatar
sajolida committed
150

151
<div class="tip">
152

sajolida's avatar
sajolida committed
153
To know your version of Tails, choose
154
155
156
157
158
<span class="menuchoice">
  <span class="guimenu">Applications</span>&nbsp;▸
  <span class="guisubmenu">Tails</span>&nbsp;▸
  <span class="guimenuitem">About Tails</span>
</span>
Tails developers's avatar
Tails developers committed
159

160
</div>