Skip to content
Check out our first blog! Read the Git & GitLab Onboarding Guide
Local Updates

Installing Local Patches

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

Note

If you don’t have the update files on your computer yet, you must get the update files first.


Installing Component Updates

This section covers common component files like admin, curriculum, control, and type.

Confirm Update is Available

Check if the component you want to install is on your computer and see which version it is.

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

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

Run the Installer

There are two different commands for installing components.

For Most Components:

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

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

For the Curriculum:

The curriculum has its own special installer.

# Install the latest curriculum (installs the newest version if you don't specify one)

tl-curriculum-install <subject> <version>

# Example: Install the latest version of the 'docs' curriculum
tl-curriculum-install docs

Verify the Installation

After the installation finishes, check 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.

Check Available Version

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

tl-comp-latest desktop

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

Apply the Update

Restore the unpacked image to apply the update.

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

Finalize

Reboot the computer to complete the installation.

sudo reboot