Troubleshooting Provisioning

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

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.”

Click to see solutions…

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.
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.

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

Click to see solutions…

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.

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

Click to see what information to provide…

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

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

Last updated on February 2, 2024