The Updating section has been redesigned! See what’s new
Install Local Updates

Installing Local Updates

This guide explains how to install updates that are already present on the local machine (from the internet, LAN, or USB).


Installing Component Updates

This section covers standard components like admin, curriculum, control, and type.

1. Confirm Update is Available

Verify that the component you want to install exists locally and check its version.

# Check for the latest 'curriculum' component
tl-comp-latest curriculum

2. Run the Installer

There are two different commands for installing components.

For Most Components:

Use the tl-archive-install command for most standard components like admin, type, control, etc.

# Install the latest available version of 'admin'
tl-archive-install admin

For the Curriculum Component:

The curriculum component has its own dedicated installer script.

# Install the latest available version of 'curriculum'
tl-curriculum-install

3. Verify the Installation

After the installation finishes, verify the new version number.

# For most components (e.g., admin)
cat /opt/admin/.version

Installing a Desktop Patch

This section covers applying a minor patch update for the Desktop (e.g., from 23.3.0 to 23.3.1) from files that are already on the computer.

For major version updates (e.g., from 23.x to 24.x)

The recommended approach is to use one of the USB Update methods.

1. Check Available Version

Verify the version of the desktop component that is available locally.

tl-comp-latest desktop

2. Unpack the Update Image

Unpack the Desktop image, replacing x.x.x with the version number you found above.

tl-img-unpack /var/btrfs x.x.x

3. Apply the Update

Restore the unpacked image to apply the update.

tl-img-restore /var/btrfs x.x.x

4. Finalize

Reboot the computer to complete the installation.

sudo reboot