Frequently Asked Questions
My computer fails to boot or drops to a shell
Click to see the fix…
If your computer fails to boot properly and drops you into a command-line shell (often called a “rootfs shell”), it may be because the bootloader is broken or misconfigured.
To fix this, you must first boot from your TechLit USB drive. Once you have booted into the USB environment, you have two options:
-
Reinstall the bootloader: This is the quickest method. Open a terminal and run the following command:
sudo tl-hw-update-bootloader /dev/sdXDevice Drive
Replace
/dev/sdXwith the correct device name for your computer’s internal drive (e.g.,/dev/sda). Uselsblkto identify it. -
Run a full desktop update:
This process is more thorough and will also repair the bootloader while updating the system. See the updating guide for detailed instructions.
My computer is slow/laggy after updating
Click to see the fix…
How do I identify my USB drive?
Click to see how…
Before performing any disk operations, it’s crucial to identify your USB drive correctly to avoid modifying the wrong device. Here are two simple methods to confirm the device name.
lsblk -o NAME,MOUNTPOINT,SIZE1. Check by Storage Size
The easiest way to distinguish your USB drive is by its size. It will almost always be significantly smaller than your computer’s internal storage (hard drive or SSD).
2. Check by Mount Points
You can also identify the drive by looking at where its partitions are mounted.
- On the TechLit Desktop OS: The main system partition is typically mounted at
/. Your USB drive will likely not be mounted, or mounted elsewhere. - In TechLit ISO (Recovery Mode): The system boots from the USB, so its partitions will be mounted on key system directories:
- The 4th partition (e.g.,
/dev/sdb4) is mounted at/srv. - The 3rd partition (e.g.,
/dev/sdb3) is mounted at/.
- The 4th partition (e.g.,
Warning
Always double-check the device name before proceeding with any operations like formatting or partitioning to avoid accidental data loss.
How do I mount my USB drive?
Click to see how…
# Identify the USB drive (say usb is /dev/sda)
lsblk
# Mount the 4th partition of the USB drive
sudo mount /dev/sda4 /mntHow do i login as admin
Click to see how…
su admin
# pass : `empowerwatoto
# if you want clean env vars
su - admin
su -l adminComponent not installed
Click to see the fix…
mkdir /srv/component_nameHow do I switch between the graphical desktop and a TTY?
Click to see how…
You can switch to a command-line interface (TTY) if the graphical desktop is frozen or for advanced tasks.
-
To switch to TTY2:
- On most computers: Ctrl + Alt + F2
- On Apple computers: CMD + Option + F2
- In rare cases: FN + Ctrl + Alt + F2
- As admin:
sudo chvt 2
-
To switch back to the graphical desktop (TTY1):
- Exit fbterm with
exitthen use Ctrl + Alt + F1. - You can also use Super + Alt + ←.
- As admin:
sudo chvt 1.
- Exit fbterm with
My computer hostname is mismatched with the tag
Click to see the fix…
Fix storage issues (“Disk Full” Error)
Click to see the fix…
If you run out of storage, the most likely culprit would be the components
Use tl-comp-manage or search Manage components in start menu.
Wi-Fi Issues
How do stop the firewall temporarily?
Click to see how…
Security Risk
Only disable if necessary. Re-enable immediately after.
rsv stop nftables # Stop the firewall
rsv start nftables # reactivate the firewallI am unable to turn on my Wi-Fi
Click to see how…
- Run
rfkill listto see all your network devices. - If your card is listed as soft blocked, run
sudo rfkill unblock wifito turn it on. - If it is hard blocked, look for a hardware switch on your computer and turn it on.
- If none of these work, try a different wifi hack in reconfigure
Device-Specific Guides
Dell XPS & Dell Mini
Click to see device-specific guides…
This section provides solutions for common issues encountered with Dell XPS and Dell Mini models.
“Invalid Partition Table” Error on Boot
This is a known issue on some Dell models that can occur during startup.
If you encounter this error message, simply press Enter to proceed. Your system will continue to boot normally.
USB Boot Failure
If you encounter the error “Selected boot device failed. Press any key to reboot the system,” follow these steps:
- Try a different USB port. A simple port change can often resolve the issue.
- Manually add the boot option in BIOS:
- Restart the computer and press
F2orF12to enter BIOS setup. - Navigate to General > Boot Sequence.
Boot list - Click Add Boot Option.
- Select your USB device and navigate to the
\EFI\BOOT\BOOTX64.EFIfile.
Boot list - Save your changes and exit BIOS. You should now be able to select the USB drive from the boot menu.
Boot list
- Restart the computer and press
USB 3.x Drive Not Detected
If your system fails to detect a USB 3.x drive, you may need to adjust the boot mode settings in the BIOS.
- Enter BIOS setup by pressing
F2orF12during startup. - Locate the boot settings and change the boot mode from BIOS/Legacy to UEFI.