The live desktop allows you to boot Clear Linux* OS in a GNOME desktop without modifying the host system, offering the chance to explore developing on Clear Linux OS. Better yet, launch the Clear Linux OS installer to install on your target system.

Preliminary steps

  1. Visit our Downloads page and download the file clear-<release number>-live-desktop.iso


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

  2. 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

Confirm network connection

Confirm there is a network connection before launching the installer. Choose a method: Wired Connection, or WiFi Connected. This guide shows an example of a Wired Connection.

  1. In the upper right of the top menu bar, select the square icon to view Network settings, shown in Figure 2.

  2. Select Wired Connected and then Wired Settings.

    Software icon, Network settings

    Figure 2: Software icon, Network settings

  3. View the Wired menu to assure that you’re target system and installer are connected to a network.

  4. Optional: Configure Proxy settings.

    1. To view Network Proxy, select its Gear icon.
    2. Select from Automatic, Manual or Disabled as desired.
    3. Close the dialogue box.
  5. Select the Gear icon to view Network settings.

  6. If desired, select Connect automatically. Select other options as desired.

  7. Select Apply button to confirm change to settings.

Software (Optional)

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


Software application is only intended for exploring available bundles, applications, and images. Do not attempt to install them.

Launch the Clear Linux OS installer

  1. After the live desktop image boots, find the Clear Linux OS installer icon in the Activities menu at left, shown in Figure 3.

  2. Click the Clear Linux OS penguin icon to launch the installer.

    Install Clear Linux OS icon

    Figure 3: Clear Linux OS installer icon

  3. The installer is launched, as shown in Figure 4.

    |CL| Desktop Installer

    Figure 4: 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.

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.
  • Checkmarks 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 checkmark 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 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. For more information, see Telemetrics.

  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.

As for bundles, you can always add more 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. Navigate to Confirm until highlighted.

  4. Select Confirm.

Optional: Skip to Finish installation.

Finish installation

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

    Assign Hostname

    Figure 16: Finish installation

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

    Required Options - Incomplete

    Figure 17: 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 adminstrative user.

Congratulations. You successfully installed Clear Linux OS.

Default partition schema

Table 1 shows the defult partition schema with the exception of root, which varies.

Table 1. Disk Partition Setup
FileSystem Mount Point Minimum size
VFAT /boot 150M
swap   256MB
root / Size depends upon use case/desired bundles.