Here are some problems you might encounter and their possible solutions.
Live Mode Without grub-live
* Kicksecure: In recent versions of Kicksecure, <code>dracut</code> is installed by default. To boot into live mode without using <code>grub-live</code>, simply add the {{CodeSelect|inline=true|code=rootovl}} kernel parameter. Instructions for adding kernel parameters can be found on the [[Grub|grub]] wiki page.
* Kicksecure for Qubes: For Qubes OS, the process may not work as expected. For further details, refer to the related Qubes feature request [https://github.com/QubesOS/qubes-issues/issues/4982 Implement live boot by porting grub-live to Qubes - amnesia / non-persistent boot / anti-forensics]
It is recommended to [[Live_Mode#Functionality Test of Live mode|Functionality Test of Live mode]] to verify non-persistence.
Missing grub-live boot menu entry
Please run the following commands for debugging/information gathering and post them when creating any support requests.
'''1.''' {{CodeSelect|inline=true|code=/etc/grub.d/10_01_linux_live}} file existence.
ls -la /etc/grub.d/10_01_linux_live
'''2.''' {{CodeSelect|inline=true|code=/etc/grub.d/10_01_linux_live}} file contents.
Please check your local file {{CodeSelect|inline=true|code=/etc/grub.d/10_01_linux_live}} to ensure it looks exactly the same as [https://github.com/Kicksecure/grub-live/blob/master/etc/grub.d/10_01_linux_live <code>/etc/grub.d/10_01_linux_live</code> on GitHub]. This will verify that you have the latest version of the <code>grub-live</code> package. Note that the stable version might look slightly different from the developer's or tester's version on GitHub.
cat /etc/grub.d/10_01_linux_live
'''3.''' <code>initramfs-tools</code> package version number.
(Probably not installed. This is expected.)
dpkg-query -W -f='${db:Status-Status}' initramfs-tools
'''4.''' <code>dracut</code> package version number.
dpkg-query -W -f='${db:Status-Status}' dracut
'''5.''' <code>dist-base-files</code> package version number.
dpkg -l {{!}} grep dist-base-files
'''6.''' <code>grub-live</code> package version number.
dpkg -l {{!}} grep grub-live
'''7.''' {{CodeSelect|inline=true|code=/boot/grub/grub.cfg}} file contents.
sudo cat /boot/grub/grub.cfg
'''8.''' Optional: Compare {{CodeSelect|inline=true|code=/boot/grub/grub.cfg}} with sample [[Grub-live#grub.cfg|grub.cfg]].
Use [[Software#File_Comparison_Tools|File Comparison Tools]].
* [[Forum_Best_Practices#Pasting_Logs_for_Support|Pasting Logs for Support]]
* [[Forum_Best_Practices#Code_Tags|Code Tags]]
Live Check Systray Issues
The live mode is indicated by a Live Check Systray icon. It can happen that this icon has issues. If so, here's what you can do.
First of all, this is '''NOT an [[Malware_and_Firmware_Trojans#Valid_Compromise_Indicators_versus_Invalid_Compromise_Indicators|indication of compromise by malware]]'''. The real issue is as simple as: '''The Live Check Systray is broken'''.
* 1) As mentioned in chapter [[read-only#VirtualBox|Combine Kicksecure Live VMs with Read-only Mode for Virtual Hard Drives chapter VirtualBox]].
If this is not an already known issue, please follow these steps:
<span class="fontsize19">1. Is livecheck.sh showing an error?</span>
If [https://github.com/{{project_name_short}}/desktop-config-dist/blob/master/usr/share/livecheck/livecheck.sh livecheck] is showing an error, it might be the following issue. Live check runs the command <code>sudo --non-interactive /bin/lsblk --noheadings --raw --output RO</code> as the current unprivileged user. You can test this for yourself with the following command. If this is working, then this is NOT the issue.
sudo --non-interactive /bin/lsblk --noheadings --raw --output RO
If this is not working, the problem might be that [https://forums.whonix.org/t/whonix-xfce-development/6213/102 this will only work by default for the user <code>user</code>], and no other user. For example, it will not work by default for the Linux user account <code>user2</code> or any other than <code>user</code>.
If the problem is that a user other than <code>user</code> is the logged-in subject, then
* '''option (A)''' the current user, for example, <code>user2</code> needs an exception in <code>/etc/sudoers.d</code>. For comparison, see file [https://github.com/{{project_name_short}}/desktop-config-dist/blob/master/etc/sudoers.d/desktop-config-dist <code>/etc/sudoers.d/desktop-config-dist</code>].
* '''option (B)''' the current user, for example, <code>user2</code> needs to be or become a member of any of the following Linux user groups:
<code>console-unrestricted</code>
<span class="fontsize19">2. Try lsblk</span>
If the above method does not work, try also this:
<span class="fontsize19">3. If nothing works, report the bug</span>
If you are still having issues, you can [[Reporting_Bugs|report a bug]] with the output from the two <code>lsblk</code> commands included above.
Technical Details of livecheck.sh
This chapter is for advanced users only.
Most users can skip this chapter. See [https://github.com/{{project_name_short}}/desktop-config-dist/blob/master/usr/share/livecheck/livecheck.sh livecheck.sh] for further script details.
* The meaning of <code>0</code> in <code>lsblk</code> output is <code>read-write</code>.
* The meaning of <code>1</code> in <code>lsblk</code> output is <code>read-only</code>.
If anything in the column <code>RO</code> is set to <code>0</code>, then it is not blessed with [[read-only|read-only hard drive mode]].
Example <code>lsblk</code> without any <code>snapd</code> installed, {{project_name_gateway_short}}, live mode, and [[read-only|read-only hard drive mode]] enabled.
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
└─sda1 8:1 0 100G 1 part /lib/live/mount/medium
Example <code>lsblk</code> without any <code>snapd</code> installed, {{project_name_gateway_short}}, live mode, and [[read-only|read-only hard drive mode]] disabled.
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
└─sda1 8:1 0 100G 0 part /lib/live/mount/medium
Example <code>lsblk</code> with <code>snapd</code> and <code>WickrMe</code> installed, {{project_name_workstation_long}}, persistent mode, and [[read-only|read-only hard drive mode]] disabled.
NAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINT
loop0 7:0 0 62.1M 1 loop /snap/gtk-common-themes/1506
loop1 7:1 0 446M 1 loop /snap/wickrme/352
loop2 7:2 0 55M 1 loop /snap/core18/1754
└─sda1 8:1 0 100G 0 part /lib/live/mount/medium
Changing from initramfs-tools to dracut is optional and can cause dracut issues, unbootable system. See [[dracut]].