Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update printer & SVS setup guide for Tails 4 #4937

Merged
merged 2 commits into from
Oct 21, 2019
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file modified docs/images/install/selectsettings.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/images/printer_setup_guide/add_printer.png
100644 → 100755
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file modified docs/images/printer_setup_guide/printer_ready.png
100644 → 100755
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file modified docs/images/printer_setup_guide/select_printer_to_add.png
100644 → 100755
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 0 additions & 7 deletions docs/includes/tails-svs-nautilus.txt

This file was deleted.

10 changes: 1 addition & 9 deletions docs/set_up_svs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -42,14 +42,6 @@ click **Add**, then click **Start Tails**.

We will now prepare the *Secure Viewing Station*.

Ensure Filenames are Preserved
------------------------------

In order to preserve filenames when you decrypt submissions, on each *Secure
Viewing Station*, you should open a **Terminal** and type the following commands:

.. include:: includes/tails-svs-nautilus.txt

Correct the System Time
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Screenshot in this section is Tails3-specific. Could be updated.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for taking care of that one, LGTM

-----------------------

Expand All @@ -62,7 +54,7 @@ To set the system time:

#. Click the upper right down arrow in the menu bar and select the wrench icon:
|select settings|
#. Then click **Date & Time**.
#. Select the **Details** section, then click **Date & Time**.
#. Click **Unlock**. Type in the admin password you set when you
started up Tails.
#. Set the correct time, region and city.
Expand Down
64 changes: 28 additions & 36 deletions docs/tails_printing_guide.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Setting Up a Printer in Tails
Because Tails is supposed to be as **amnesiac** as possible, you want to
shield your Tails stick from any extra inputs from, and outputs to, a
potentially untrusted network. This is why **we strongly recommend using
a printer that does not have WiFi or Bluetooth**, and hooking up to it
a printer that does not have WiFi or Bluetooth**, and connecting to it
using a regular USB cable to print.

Finding a printer that works with Tails can be challenging because Tails is
Expand Down Expand Up @@ -36,59 +36,52 @@ increase the chances for a seamless installation experience in Tails.
In any case, this document outlines the usual set of steps that we follow when
attempting to use a new printer with Tails.

.. note:: While, as of Tails 3, it's no longer necessary to have admin
privileges in order to install or configure printers, we recommend that you
set an admin passphrase and unlock your persistent volume; this ensures that
the printer's installation and configuration settings persist after every
reboot, so you don't have to reinstall it each time you start Tails.

Installing and Printing via the Tails GUI
-----------------------------------------

Let's look at Tails 3.0's typical flow for installing a USB-connected printer.
If you've enabled persistence, boot with your persistent volume, and set an
admin passphrase. Connect the printer to your Tails-booted computer via USB,
then turn the printer on.
Let's look at the flow in Tails 4 for installing a USB-connected printer.
On the Tails welcome screen, unlock your persistent volume, and
`set an admin password <https://tails.boum.org/doc/first_steps/startup_options/administration_password/index.en.html>`__.
This ensures that you won't have to reinstall the printer each time you start
Tails.

Connect the printer to your Tails-booted computer via USB, then turn the printer
on.

Now, you'll want to single-click your way through **Applications** ▸
**System Tools** ▸ **Settings** ▸ **Printers**.
**System Tools** ▸ **Settings** ▸ **Devices** ▸ **Printers**. The screenshot
below highlights the "Devices" section in which the printer settings can be
found:

|select printer from settings|
|select devices from settings|

In this example, we'll assume that this is the first time we've tried to install
a printer, which will show the following:
If this is the first time you've tried to install a printer, the "Printers"
section will look like this:

|add printer|

Click **Add a Printer**. By doing so, you'll now get a list of printers that Tails
has auto-detected. You should now see this:
Click **Add a Printer**. After a brief period during which Tails searches for
printers, you should see a list of printers that Tails has auto-detected:

|select printer to add|

In this example, we've connected an HP DeskJet F4200. Clicking on this printer
will select it for installation, which, if successful, will display the
following:
In this example, we've connected an HP ENVY-5530 (not a model we recommend for
production use). Clicking on this printer will select it for installation. The
installation can take a few seconds, during which it looks like nothing is
happening.

|printer installing|

This indicates that Tails is attempting to install the USB printer. Assuming you
receive no errors in this process, you will then see the following screen,
which indicates that the printer is "ready" for printing.
Assuming you receive no errors in this process, you will then see a screen like
the following one, which indicates that the printer is ready for printing.

|printer ready|






Printing from the Command Line
------------------------------

You can also easily print from the command line using the ``lp`` command; if
you haven't already set your installed printer as default in the GUI, you can
quickly do so by adding this line to your ``~/.bashrc`` file, or entering this
directly into the terminal:
After you have configured your printer, you can also easily print from the
command line using the ``lp`` command. If you haven't already set your installed
printer as default in the GUI, you can quickly do so by adding this line to your
``~/.bashrc`` file, or entering this directly into the terminal:

.. code:: sh

Expand All @@ -113,7 +106,6 @@ it's equally straightforward from the command line, if you prefer that
environment.

.. |select printer to add| image:: images/printer_setup_guide/select_printer_to_add.png
.. |select printer from settings| image:: images/printer_setup_guide/select_printer_from_settings.png
.. |select devices from settings| image:: images/printer_setup_guide/select_devices_from_settings.png
.. |printer ready| image:: images/printer_setup_guide/printer_ready.png
.. |printer installing| image:: images/printer_setup_guide/printer_installing.png
.. |add printer| image:: images/printer_setup_guide/add_printer.png