Skip to content

Commit

Permalink
Add 1.2.0 to 1.2.1 update guide for workstations
Browse files Browse the repository at this point in the history
(cherry picked from commit 71924ca)
  • Loading branch information
eloquence committed Feb 19, 2020
1 parent 0e9a0bb commit d3a3aa2
Show file tree
Hide file tree
Showing 2 changed files with 69 additions and 0 deletions.
1 change: 1 addition & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,7 @@ anonymous sources.
:name: upgradetoc
:maxdepth: 2

upgrade/1.2.0_to_1.2.1.rst
upgrade/1.1.0_to_1.2.0.rst
upgrade/1.0.0_to_1.1.0.rst
upgrade/xenial_after_april_30.rst
Expand Down
68 changes: 68 additions & 0 deletions docs/upgrade/1.2.0_to_1.2.1.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
Upgrade from 1.2.0 to 1.2.1
===========================

Updating Workstations to SecureDrop 1.2.1
-----------------------------------------

Using the graphical updater
~~~~~~~~~~~~~~~~~~~~~~~~~~~
On the next boot of your SecureDrop *Journalist* and *Admin Workstations*,
the *SecureDrop Workstation Updater* will alert you to workstation updates. You
must have `configured an administrator password <https://tails.boum.org/doc/first_steps/startup_options/administration_password/>`_
on the Tails welcome screen in order to use the graphical updater.

Perform the update to 1.2.1 by clicking "Update Now":

.. image:: ../images/securedrop-updater.png

Performing a manual update
~~~~~~~~~~~~~~~~~~~~~~~~~~
If the automated update fails, you can perform a manual update by running the
following commands: ::

cd ~/Persistent/securedrop
git fetch --tags
gpg --keyserver hkps://keys.openpgp.org --recv-key \
"2224 5C81 E3BA EB41 38B3 6061 310F 5612 00F4 AD77"
git tag -v 1.2.1

The output should include the following two lines: ::

gpg: using RSA key 22245C81E3BAEB4138B36061310F561200F4AD77
gpg: Good signature from "SecureDrop Release Signing Key"

Please verify that each character of the fingerprint above matches what
on the screen of your workstation. If it does, you can check out the
new release: ::

git checkout 1.2.1

.. important:: If you do see the warning "refname '1.2.1' is ambiguous" in the
output, we recommend that you contact us immediately at [email protected]
(`GPG encrypted <https://securedrop.org/sites/default/files/fpf-email.asc>`__).

Finally, run the following commands: ::

./securedrop-admin setup
./securedrop-admin tailsconfig

Upgrading Tails
---------------
If you have already upgraded your workstations to Tails 4, follow the graphical
prompts to update to the latest version.

.. important::

If you are still running Tails 3.x on any workstation, we urge you to update
to the Tails 4 series as soon as possible. Tails 3.x is no longer receiving
security updates, and is no longer supported by the SecureDrop team.
Please see our
:ref:`instructions for upgrading to Tails 4 <upgrade_to_tails_4>`.

Getting Support
---------------

Should you require further support with your SecureDrop installation, we are
happy to help!

.. include:: ../includes/getting-support.txt

0 comments on commit d3a3aa2

Please sign in to comment.