upgrade.mdwn 5.41 KB
Newer Older
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>

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>

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

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:

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

sajolida's avatar
sajolida committed
53
After connecting to Tor, if an upgrade is available, a dialog appears and
54
proposes you to upgrade your USB stick.
Tails developers's avatar
Tails developers committed
55

56
[[!img upgrader_automatic.png link=no]]
Tails developers's avatar
Tails developers committed
57 58 59 60 61 62 63 64 65 66 67 68 69

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

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
After connecting to Tor, a dialog informs you if you have to
148 149
upgrade your USB stick using <span class="application">Tails Installer</span>
to a newer version of Tails.
sajolida's avatar
sajolida committed
150
To do so, follow our [[manual upgrade instructions|/upgrade]].
151

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

154
<div class="tip">
155

sajolida's avatar
sajolida committed
156
To know your version of Tails, choose
157 158 159 160 161
<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
162

163
</div>