From bcc9673178fc13e878512ed7ab0e7e913b3955a2 Mon Sep 17 00:00:00 2001 From: PROTechThor Date: Sat, 21 Nov 2020 12:26:46 +0100 Subject: [PATCH] Add Tails Troubleshooting --- doc.md | 1 + external/privacy-guides/tails.md | 36 ++++--------------- .../troubleshooting/tails-troubleshooting.md | 33 +++++++++++++++++ 3 files changed, 40 insertions(+), 30 deletions(-) create mode 100644 external/troubleshooting/tails-troubleshooting.md diff --git a/doc.md b/doc.md index 9b5982ab..7972089b 100644 --- a/doc.md +++ b/doc.md @@ -283,6 +283,7 @@ For more, please see [Qubes Community Documentation](https://github.com/Qubes-Co * [Sony Vaio Troubleshooting](/doc/sony-vaio-tinkering/) * [Intel Integrated Graphics Troubleshooting](/doc/intel-igfx-troubleshooting/) * [Multiboot Troubleshooting](/doc/multiboot/#troubleshooting) + * [Tails Troubleshooting](/doc/tails-troubleshooting/) ### Building Guides diff --git a/external/privacy-guides/tails.md b/external/privacy-guides/tails.md index be209018..a159df4a 100644 --- a/external/privacy-guides/tails.md +++ b/external/privacy-guides/tails.md @@ -47,36 +47,7 @@ To run Tails under Qubes: 7. Use Tails as normal. -## Usage Notes - -### Display issues: -**Black screen on start up.** - -This was reported with earlier versions of Tails: The problem should now be fixed. -If you do encounter this problem, you can try to constrain display settings by appending vga codes to the Tails boot parameters. -(If you do not know the codes, append `vga=999`, and a helpful prompt will appear.) - -N.B Tails 2.3 does not appear to honour the vga code. - -**Window extends beyond the bottom of the screen.** - -This seems to arise because Tails sizes to the height of the screen, but there is a title bar at the top of the window. -Either remove the title bar altogether, or move the window upwards using ALT+drag. - -### Persistent Volume -The persistence tools will not work because Tails has not been launched from USB. -The HVM disk(s) can be configured and mounted from within Tails to provide persistent storage. -If you want to use an existing USB persistent volume: - - Interrupt the Tails vm boot process with arrow-up when the grub boot menu appears. - - In dom0 attach the USB drive containing the persistent volume to the Tails vm. - - Continue booting Tails: Tails-greeter will detect the encrypted partition on the attached USB. - - Unlock the persistent volume in Tails-greeter and use it as normal. - -### Shutdown -The Tails qube will not shut down cleanly. -Kill it from the GUI Manager or ```qvm-kill Tails``` in Konsole. - -### Security +## Security You will probably want to implement [MAC spoofing](/doc/anonymizing-your-mac-address/). There are added security concerns for Tails users when running it in a virtual machine. @@ -84,3 +55,8 @@ If you intend to do this, you should read [the warnings](https://tails.boum.org/ While the Qubes security model mitigates most of the risks identified, traces of the Tails session may remain on the disk. Live booting Tails, though less convenient, is always more secure than using it inside virtualization software or Qubes, because you don't run the added risk of the virtualization software or Host OS being compromised. Depending on your threat model, this might induce too much risk. + +## Troubleshooting + +See the [Tails Troubleshooting guide](/doc/tails-troubleshooting/). + diff --git a/external/troubleshooting/tails-troubleshooting.md b/external/troubleshooting/tails-troubleshooting.md new file mode 100644 index 00000000..2d5d855f --- /dev/null +++ b/external/troubleshooting/tails-troubleshooting.md @@ -0,0 +1,33 @@ +--- +layout: doc +title: Tails Troubleshooting +permalink: /doc/tails-troubleshooting/ +--- + +# Tails Troubleshooting Guide # + +## Black screen during startup + +This was reported with earlier versions of Tails -- the problem should now be fixed. +If you do encounter a black screen during Tails startup, you can try to constrain display settings by appending vga codes to the Tails boot parameters. +If you do not know the codes, append `vga=999`, and a helpful prompt will appear. + +Note: Tails 2.3 does not appear to honour the vga code. + +## Window extends beyond the bottom of the screen + +This problem seems to arise because Tails sizes to the height of the screen, but there is a title bar at the top of the window. +Either remove the title bar altogether, or move the window upwards using ALT+drag. + +## Persistent tools do not work +The persistence tools, such as persistent volume, may not work because Tails has not been launched from USB. +The HVM disk(s) can be configured and mounted from within Tails to provide persistent storage. +If you want to use an existing USB persistent volume: +1. Interrupt the Tails vm boot process with arrow-up when the grub boot menu appears. +2. In dom0 attach the USB drive containing the persistent volume to the Tails VM. +3. Continue booting Tails. Tails-greeter will detect the encrypted partition on the attached USB. +4. Unlock the persistent volume in Tails-greeter and use it as normal. + +## Tails qube doesn't shut down cleanly +If the Tails qube will not shut down cleanly, you can kill it from the GUI Manager or enter ```qvm-kill Tails``` in the console. +