.. _pureos_troubleshooting_installation:

Installation
============


.. _pureos_troubleshooting_installation_boot_options:

PureOS boot screen does not appear
----------------------------------

**Problem**:

The PureOS boot screen does not appear after booting into a USB flash drive.

**Solution**:

Try the following:

#. Disable secure boot/UEFI boot on your computer's BIOS and try again
#. Make sure you followed the desired procedure to create a bootable USB drive:
    * :ref:`Etcher <pureos_installation_prepare_sd_etcher>`
    * :ref:`GNOME Disks <pureos_installation_prepare_sd_gnome_disks>`
    * :ref:`dd command <pureos_installation_prepare_sd_dd>`
#. ISO image you burned to your USB might not be downloaded correctly, ensure the download is okay by :ref:`verifying its sha256 checksum <pureos_image_verify>`


.. _pureos_troubleshooting_installation_incomplete:

Installation was incomplete
---------------------------

Installation process stopped before completion.

**Problem**

Installation freezes between 40% and 60%.
If encryption is DISABLED, installation goes fine.

**Solution**

This can occur if the system has run out of entropy ("randomness") while creating the encrypted partition.
Don't interrupt the setup, but simply open a text editor and start typing random text.
You can also move the cursor around to generate more entropy.

If you wish to measure how much entropy you have available, you can run this commans on the command line:

.. code-block:: bash

   cat /proc/sys/kernel/random/entropy_avail


.. _pureos_troubleshooting_drivers:

Drivers
-------


.. _pureos_troubleshooting_drivers_byd:

No touchpad settings available in GNOME control center
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

**Problem**

No touchpad settings are available in GNOME control center.
This occurs when the BYD touchpad on Librem 13 rev1/Librem 15v2 is not detected/recognized.

**Check**

Check if the touchpad driver is loaded (execute this command in your terminal):

.. code-block:: bash

   cat /sys/bus/serio/devices/serio1/protocol

If the command returns **ImPS/2**, then the BYD touchpad driver is not loaded.

**Solution**

.. note::
   This only applies to laptops with BYD touchpads, notably **Librem 13 rev1** and **Librem 15 rev2**.

Create a file (if doesn't exist) ``/etc/rc.local`` with the following content:

.. code-block:: bash

   #!/bin/bash
   echo -n byd > /sys/bus/serio/devices/serio1/protocol

The file must be executable.

Terminal command to do all this:

.. code-block:: bash

   sudo touch /etc/rc.local
   sudo sh -c 'echo "#!/bin/bash\necho -n byd > /sys/bus/serio/devices/serio1/protocol" > /etc/rc.local'
   sudo chmod +x /etc/rc.local

Restart the computer for this to take effect.


.. _pureos_troubleshooting_drivers_missing_firmware:

Missing firmware
^^^^^^^^^^^^^^^^

Missing firmware for a device

**Problem**

A device on my computer does not work with PureOS.
Logs say something about missing firmware.

**Check**

PureOS is designed to support only devices which do not require non-free/proprietary binary drivers or firmware, meaning it *does not have* such drivers/firmware.
Check if your computer have such devices (AMD or nVidia graphics, Intel or newer Broadcom wireless LAN cards, etc).

**Solution**

Check if the ``firmware-linux-free`` package is installed.
If it is not installed, install it.
If the device requires non-free/proprietary binary drivers/firmware, it will not work in PureOS.