Skip to content
Curriculum got split! Check out how to install them now or see what’s new
`CTRL K`

Guides
Setup & Repair
Troubleshoot

# Troubleshooting Provisioning

This guide helps you solve common issues that can occur during the device provisioning process.

### Problem: The USB drive won’t boot

This can happen in a few ways: the computer boots to the old OS, it gets stuck in a loop, or it shows an error like “Selected boot device failed.”

Solutions for Boot Issues

1. Try a different USB port. Sometimes switching from a USB 2.0 (black) to a USB 3.0 (blue) port, or vice-versa, can solve the problem.

2. Check the BIOS/UEFI settings. You may need to enter the full BIOS setup menu to make changes. - Accessing BIOS Setup: The key is usually `F1`, `F2`, `F10`, or `DEL`. - Enable USB Boot: Look for an option to “Enable USB Boot” and make sure it is turned on. - Disable Secure Boot: If you see an option for “Secure Boot”, try disabling it. - Switch Boot Mode: Try switching the boot mode from `UEFI` to `Legacy/CSM` or vice-versa. - Manually Add Boot Option: Some BIOS versions require you to manually add the USB drive as a trusted boot option. Look for a “Boot Sequence” or “Add Boot Option” menu. The file to select on the USB is usually `\EFI\BOOT\BOOTX64.EFI`.

        ![An example of a Dell BIOS Menu](dell_bios.jpg)

### Problem: I ran the command with the wrong information

If you made a mistake while running `tl-hw-prepare` or `tl-hw-update-desktop`.

Solutions for Incorrect Commands

- Wrong Tag, Wi-Fi Name, or Password: Don’t worry. Let the installation finish. Once you boot into the desktop, you can easily fix these settings using the `tl-sys-configure` tool.

### Problem: I’m still stuck

If you’ve tried the steps above and are still having issues, you can ask for help.

Information to Provide When Asking for Help

To get the best help, please provide as much information as possible:

1. Computer Details: The brand and model of the computer (e.g., “HP Elitebook 840 G3”).
2. Commands You Ran: The exact command you used (e.g., `tl-hw-prepare /dev/sda tl-1234`).
3. Observed Behavior: What exactly happened? Note any error messages you saw on the screen or describe where the process got stuck.

Install / Update