Skip to content

Commit

Permalink
Add instructions on updating Tails USBS.
Browse files Browse the repository at this point in the history
Refer to updates instead of upgrades. Clarify generic Tails manual update process. Add warning to Tails Setup docs on verifying iso image. Additional changes in wording per pr review.
  • Loading branch information
rocodes committed Sep 9, 2019
1 parent 01fbef7 commit 8a52d7d
Show file tree
Hide file tree
Showing 4 changed files with 110 additions and 1 deletion.
Binary file added docs/images/tails_update_notification.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -77,6 +77,7 @@ anonymous sources.
yubikey_setup
backup_and_restore
backup_workstations
update_tails_usbs
rebuild_admin
kernel_troubleshooting
getting_support
Expand Down
6 changes: 5 additions & 1 deletion docs/set_up_tails.rst
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,11 @@ drives which were created via the Tails Installer*.

The `Tails website <https://tails.boum.org/>`__ has detailed and
up-to-date instructions on how to download and verify Tails, and how to
create a bootable Tails USB drive. Follow the instructions at these
create a bootable Tails USB drive.

.. important:: Make sure you verify the Tails .iso using one of the methods described on the Tails website.

Follow the instructions at these
links and then return to this page:

- `Download and verify the Tails
Expand Down
104 changes: 104 additions & 0 deletions docs/update_tails_usbs.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
Updating Tails USBs
===================

You are responsible for keeping your Tails USBs updated.

There are two ways to perform updates: via the Tails graphical installer and manually. The manual update process will work on any Tails USB. The graphical installer requires an Internet connection to notify you when updates are available, so it is only suitable for internet-connected Tails workstations (such as the *Admin Workstation* and the *Journalist Workstation*).

Because the *Secure Viewing Station* (SVS) is airgapped, it cannot receive update notifications, so it will need to be updated manually.

.. important::
The *SVS* stores some of SecureDrop's most sensitive data (decrypted submissions, the *Submission Private Key*), so we **strongly** encourage you to manually update the *SVS* whenever a new version of Tails is released.

The Tails project releases updates `every 6 to 8 weeks`_. Occasionally they
release a new version ahead of the normal cycle in order to address a
security issue. For regular Tails OS and security information, check out the
Tails `Security page`_ and subscribe to the Tails RSS/Atom feed.

.. _every 6 to 8 weeks: https://tails.boum.org/contribute/calendar/
.. _Security page: https://tails.boum.org/security/index.en.html


Update via Graphical Installer
------------------------------

For Internet-connected Tails workstations, you'll see a notification when a new version of Tails is available.

|Update Notification|

We recommend that you back up your existing configuration and `update as soon as possible`_. It usually takes some time for updates to download, so keep that in mind when choosing when to update.

.. |Update Notification| image:: images/tails_update_notification.png
.. _update as soon as possible: https://docs.securedrop.org/en/stable/backup_workstations.html

Update Manually
---------------

The process for manually updating a Tails USB is:

#. Recommended: :ref:`Make a backup of the USB you want to update <Step 1>`.
#. Install the :ref:`latest version of Tails <Step 2>` on your *primary Tails USB* or a blank USB stick.
#. Use the *primary Tails USB* to :ref:`perform a manual update of your desired Tails USB <Step 3>` on a fully offline (airgapped) computer, such as the computer used for the *Secure Viewing Station*.

What you need
^^^^^^^^^^^^^

#. Your *Admin Workstation* computer
#. A *primary Tails USB* stick (you may still have one; it was used to create the *Admin Workstation*, *Secure Viewing Station*, and *Journalist Workstation* Tails USBs during the initial SecureDrop install process)
#. The Tails USB that you want to update
#. A Backup USB to back up the data on your existing Tails USBs
#. An airgapped computer, such as the computer used for the *Secure Viewing Station*.

.. _Step 1:

1. Back up your Tails USB
^^^^^^^^^^^^^^^^^^^^^^^^^

`Follow the instructions`_ to back up your existing Tails USB.

.. _Follow the instructions: https://docs.securedrop.org/en/stable/backup_workstations.html

.. _Step 2:

2. Get the latest version of Tails
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If you have an existing *primary Tails USB*, boot into it on your *Admin Workstation* computer and follow the graphical updater prompts that guide you through the `update process`_.

Alternatively, you can also download and `install the newest version of Tails from scratch`_ (as you did when you first installed SecureDrop). This may be faster if your *primary Tails USB* has not been updated in a while.

.. _update process: https://tails.boum.org/doc/first_steps/upgrade/index.en.html

.. _install the newest version of Tails from scratch: https://docs.securedrop.org/en/stable/set_up_tails.html#install-tails

.. _Step 3:

3. Perform airgapped update
^^^^^^^^^^^^^^^^^^^^^^^^^^^

In this step, use the up-to-date *primary Tails USB* to update your desired Tails USB.

.. warning::
The entire *Secure Viewing Station* is designed to be airgapped, so
the *SVS* Tails USB should **never** be plugged into a computer with
a network connection.

Use an airgapped computer, such as the *Secure Viewing Station* computer, to perform the steps in this section.

Plug your *primary Tails USB* into the airgapped computer and boot into Tails.

You can then perform the `manual update steps`_.

.. _manual update steps: https://tails.boum.org/upgrade/clone-overview/index.en.html


If you encounter issues
^^^^^^^^^^^^^^^^^^^^^^^

If you run into issues, you can always restore your data from the backup device following the instructions `here`_.

If you continue to have problems, you can contact us through the `SecureDrop Support Portal`_.

.. _SecureDrop Support Portal: https://securedrop-support.readthedocs.io/en/latest/

.. _here: https://docs.securedrop.org/en/release-0.14.0/backup_workstations.html#restoring-a-workstation-from-a-backup

0 comments on commit 8a52d7d

Please sign in to comment.