summaryrefslogtreecommitdiffstats
path: root/wiki/src/doc/first_steps/upgrade.mdwn
blob: 67f660ca55210b245787f5335d970b9332d854af (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
[[!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="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 USB stick, was
installed using <span class="application">Tails Installer</span>. **The
persistent storage on the USB stick will be preserved.**

<div class="note">

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

<p>If you use Tails from a USB stick installed from macOS using the
command line, you need to [[reinstall|install/mac/usb/overview]].</p>

</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 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 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 USB stick, installed using
    <span class="application">Tails Installer</span>.
  - 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]]

<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.

<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
is 1.3.2, then the upgrade to 1.3.1 will be installed, and after you restart Tails, the
upgrade to 1.3.2 will be installed.

</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>

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

</div>

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="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>

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

</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.
To do so, follow our [[manual upgrade instructions|/upgrade]].

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