The Updating section has been redesigned! See what’s new
`CTRL K`

Docs
Device Provisioning
Install / Update

# Step 2: Install or Update the System

After booting from the USB, you will use commands to install or update the TechLit OS on the computer’s internal drive.

For Mini Devices (<20GB Storage)

This guide is for standard devices. If your computer has less than 32GB of storage, you must follow the Mini Device Update Guide instead. Attempting to use the standard process on a mini device will fail due to lack of space.

### Step 2.1: Identify the Internal Drive

    lsblk

> Look for the main drive, which is usually much larger than your USB drive. Common names are `/dev/sda`, `/dev/nvme0n1`, or `/dev/mmcblk0`. You will use this name in the next step.

### Step 2.2: Choose Your Action

Choose one of the two actions below.

### Option A: Fresh Install (`tl-hw-prepare`)

### Click to see details…

Use this command for a new computer or to completely wipe and reinstall an existing one.

Caution

This command will permanently erase all data on the target drive.

    # Replace /dev/sdX with your drive and tl-xxxx with the tag
    tl-hw-prepare /dev/sdX tl-xxxx

### Option B: Update Existing System (`tl-hw-update-desktop`)

Click to see details…

Use this command to update an existing TechLit computer without wiping its data.

    # Replace /dev/sdX with your drive
    tl-hw-update-desktop /dev/sdX

### Step 2.3: Finalize

Click to see details…

Once the script finishes, you will see a success message.

Simply reboot the computer by typing `reboot` and pressing Enter.

Note

Unplug the USB drive immediately after the computer restarts to prevent it from booting back into the installer.

Examples

- Install on a computer with drive `/dev/nvme0n1` and tag `tl-0606`:

      tl-hw-prepare /dev/nvme0n1 tl-0606

- Install and set the Wi-Fi name at the same time:

      WIFI_NAME="TechLit Emacs" tl-hw-prepare /dev/nvme0n1 tl-0606

- Update a computer with drive `/dev/sda`:

      tl-hw-update-desktop /dev/sda

- Update to a specific version on the USB:

      tl-hw-update-desktop /dev/sda 23.1.1

Troubleshoot