Install Clear Linux* OS from the live desktop

This page explains how to boot the Clear Linux* OS live desktop image, from which you can install Clear Linux OS or explore without modifying the host system.

System requirements

Before installing Clear Linux OS, verify that the host system supports the installation:

Preliminary steps

  1. Visit our Downloads page.

  2. Download the file clear-<release number>-live-desktop.iso, also called the Clear Linux OS Desktop.


    <release-number> is the latest Clear Linux OS auto-numbered release.

  3. Verify and decompress the file per your OS.

  4. Follow your OS instructions to create a bootable USB drive.

Install from live image

After you download and burn the live desktop image on a USB drive, follow these steps.

  1. Insert the USB drive into an available USB slot.

  2. Power on the system.

  3. Open the system BIOS setup menu by pressing the F2 key. Your BIOS setup menu entry point may vary.

  4. In the setup menu, enable the UEFI boot and set the USB drive as the first option in the device boot order.

  5. Save these settings, e.g. F10, and exit.

  6. Reboot the target system.

  7. Select Clear Linux OS in the boot menu, shown in Figure 1.

    Clear Linux OS in boot menu

    Figure 1: Clear Linux OS in boot menu

Software (optional)

Explore Clear Linux OS bundles and other software. Double-click the Software icon from the Activities menu, shown in Figure 2. Ensure a network connection exists before launching the Software application.


While running the Clear Linux OS live desktop image, the Software application is intended only for exploration. Do not attempt to install applications during exploration.

Launch the Clear Linux OS installer

  1. After the live desktop image boots, scroll over the vertical Activities menu at left.

  2. Click the Clear Linux OS penguin icon to launch the installer, shown in Figure 2.

    Install Clear Linux OS icon

    Figure 2: Clear Linux OS installer icon

  3. After the installer is launched, it will appear as shown in Figure 3.

    |CL| Desktop Installer

    Figure 3: Clear Linux OS OS Desktop Installer

  4. In Select Language, select a language from the options, or type your preferred language in the search bar.

  5. Select Next.

Checking prerequisites

The installer automatically launches Checking Prerequisites, which checks your target system for compatibility and network connectivity.

After the installer shows Prerequisites passed, select Next to proceed with installation.

Checking Prerequisites

Figure 4: Checking Prerequisites

Network Proxy (optional)

  1. Configure Network Proxy settings.
  2. In the top right menu bar, select the Power button.
  3. Select Wired Connected and then Wired Settings.
    1. In Network Proxy, select the Gear icon to view options.
    2. Select an option from Automatic, Manual or Disabled.
    3. Close Network Proxy.
  4. Close Settings.

Minimum installation requirements

To fulfill minimum installation requirements, complete the Required options. We also recommend completing Advanced options.


  • The Install button is only highlighted after you complete Required options.
  • Check marks indicate a selection has been made.
  • An Internet connection is required. You may want to launch a browser prior to installation to verify your Internet connection.

Clear Linux OS Desktop Installer

The Clear Linux OS Desktop Installer Main Menu appears as shown in Figure 5. To meet the minimum requirements, enter values in all submenus for the Required options. After you complete them, your selections appear below submenus and a check mark appears at right.

Clear Linux OS Desktop Installer - Main Menu

Figure 5: Clear Linux OS Desktop Installer - Main Menu

Required options

Select Time Zone

  1. From the Main Menu, select Select Time Zone. UTC is selected by default.

  2. In Select Time Zone, navigate to the desired time zone. Or start typing the region and then the city. (.e.g., America/Los_Angeles).

  3. Select Confirm.

    Select System Timezone

    Figure 6: Select System Time Zone

Select Keyboard

  1. From the Main Menu, select Select Keyboard.

  2. Navigate to your desired keyboard layout. We select “us” for the United States.

  3. Select Confirm.

    Select Keyboard menu

    Figure 7: Select Keyboard menu

Select Installation Media

  1. From the Main Menu, select Select Installation Media.

  2. Choose an installation method: Safe Installation or Destructive Installation.

    Select Installation Media

    Figure 8: Select Installation Media

Safe Installation

Use this method to safely install Clear Linux OS on media with available space, or alongside existing partitions, and accept the Default partition schema. If enough free space exists, safe installation is allowed.


Clear Linux OS allows installation alongside another OS. Typically, when you boot your system, you can press an F key to view and select a bootable device or partition during the BIOS POST stage. Some BIOSes present the Clear Linux OS partition, and you can select and boot it. However, other BIOSes may only show the primary partition, in which case you will not be able boot Clear Linux OS. Be aware of this possible limitation.

Destructive Installation

Use this method to destroy the contents of the target device, install Clear Linux OS on it, and accept the Default partition schema.

Disk encryption

For greater security, disk encryption is supported using LUKS. Encryption is optional.

  1. To encrypt the root partition, select Enable Encryption, as shown in Figure 9.

    Enable Encryption

    Figure 9: Enable Encryption

  2. When Encryption Passphrase appears, enter a passphrase.

    Encryption Passphrase

    Figure 10: Encryption Passphrase


    Minimum length is 8 characters. Maximum length is 94 characters.

  3. Enter the same passphrase in the second field.

  4. Select Confirm in the dialogue box.


    Confirm is only highlighted if passphrases match.

  5. Select Confirm in submenu.

Manage User

  1. In Required Options, select Manage User.

  2. In User Name, enter a user name.

    Manage User

    Figure 11: Manage User

  3. In Login, create a login name. It must start with a letter and can use numbers, hyphens, and underscores. Maximum length is 31 characters.

  4. In Password, enter a password. Minimum length is 8 characters. Maximum length is 255 characters.

  5. In Confirm, enter the same password.


    Administrator rights are selected by default. For security purposes, the default user must be assigned as an Administrator.

  6. Select Confirm.


    Select Cancel to return to the Main Menu.

Modify User

  1. In Manager User, select Manage User.

  2. Modify user details as desired.

  3. Select Confirm to save the changes you made.


    Optional: Select Cancel to return to the Main Menu to revert changes.

Optional: Skip to Finish installation.


Choose whether to participate in telemetry. Telemetrics is a Clear Linux OS feature that reports failures and crashes to the Clear Linux OS development team for improvements.

  1. From Required Options, select Telemetry.

  2. Select Yes.

    Enable Telemetry

    Figure 12: Enable Telemetry

  3. If you don’t wish to participate, select No.

Advanced options

After you complete the Required options, we recommend completing Advanced options–though they’re not required. Doing so customizes your development environment, so you’re ready to go immediately after reboot.


You can always add more bundles later with swupd.

Bundle Selection

  1. On the Advanced menu, select Bundle Selection

  2. Select your desired bundles.

    Bundle Selection

    Figure 13: Bundle Selection

  3. Select Confirm.

  4. View the bundles that you selected.

    Bundle Selections - Advanced Options

    Figure 14: Bundle Selections - Advanced Options

Optional: Skip to Finish installation.

Assign Hostname

  1. In Advanced Options, select Assign Hostname.

  2. In Hostname, enter the hostname only (excluding the domain).

    Assign Hostname

    Figure 15: Assign Hostname


    Hostname does not allow empty spaces. Hostname must start with an alphanumeric character but may also contain hyphens. Maximum length of 63 characters.

  3. Select Confirm.

Optional: Skip to Finish installation.

Kernel Configuration

  1. In Kernel Configuration, navigate to select your desired kernel. Native is selected by default.

    Kernel Configuration

    Figure 16: Kernel Configuration

  2. To add arguments, enter the argument in Add Extra Arguments.

  3. To remove an argument, enter the argument in Remove Arguments.

  4. Select Confirm.

Software Updater Configuration

  1. In Advanced Options, select Software Updater Configuration.

  2. In Mirror URL, follow the instructions if you wish to specify a different installation source.

  3. Enable Auto Updates is selected by default. If you do not wish to enable automatic software updates, uncheck the box.

    Software Updater Configuration

    Figure 17: Software Updater Configuration

  4. Select Confirm.

Finish installation

  1. When you are satisfied with your installation configuration, select Install.

    Assign Hostname

    Figure 18: Finish installation

  2. If you do not enter a selection for all Required Options, the Install button remains disabled, as shown in Figure 19. Return to Required Options and make selections.

    Required Options - Incomplete

    Figure 19: Required Options - Incomplete

  3. After installation is complete, select Exit.

  4. Shut down the target system.

  5. Remove the USB or any installation media.

  6. Power on your system.


    Allow time for the graphical login to appear. A login prompt shows the administrative user that you created.

  7. Log in as the administrative user.

Congratulations. You successfully installed Clear Linux OS.

Default partition schema

Create partitions per requirements in Table 1.

Table 1. Default partition schema
FileSystem Label Mount Point Default size
VFAT (FAT32) boot /boot 150MB
linux-swap swap   256MB
ext[234] or XFS root / Size depends upon use case/desired bundles.