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.

    Note

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

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

Note

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.

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.

Note

  • 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 4. 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 4: 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 5: 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 6: 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 7: 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.

Note

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

    Enable Encryption

    Figure 8: Enable Encryption

  2. When Encryption Passphrase appears, enter a passphrase.

    Encryption Passphrase

    Figure 9: Encryption Passphrase

    Note

    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.

    Note

    Confirm is only highlighted if passphrases match.

  5. Select Confirm in submenu.

Advanced Installation

Use this method to manually partition the target media using gparted. Our example uses the Default partition schema. The space you allocate for root, or additional partitions, may vary.

  1. Select Advanced Installation.

  2. Select Partition Media, shown in Figure 11.

    Advanced Installation

    Figure 10: Advanced Installation

boot partition

  1. Select the available target media shown as unallocated.

    Advanced Disk Partitioning

    Figure 11: Advanced Disk Partitioning

  2. Choose Device ‣ Create Partition Table.

  3. In the Warning screen, under Select new partition table type , select gpt from the pull-down menu.

  4. Select Apply.

  5. Select Partition ‣ New.

    Note

    The /boot partition must be VFAT(FAT32).

  6. In Create new Partition, complete the following fields to match Figure 12. Don’t change other default values.

    • New size: 150
    • Partition name: CLR_BOOT
    • File system: fat32
    • Label: boot
    boot partition

    Figure 12: boot partition

  7. Select Add.

swap partition

  1. With unallocated highlighted, select from the menu Partition ‣ New.

  2. In Create new Partition, complete the following fields to match Figure 13. Don’t change other default values.

    • New size: 256
    • Partition name: CLR_SWAP
    • File system: linux-swap
    • Label: swap
    swap partition

    Figure 13: swap partition

  3. Select Add.

root partition

  1. With unallocated highlighted, select from the menu Partition ‣ New.

  2. In Create new Partition, complete the following fields to match Figure 14. Don’t change other default values.

  3. In New size, enter the desired size, or leave as is to accept the default: remaining size.

    • New size: <varies>
    • Partition name: CLR_ROOT
    • File system: ext[234] or XFS
    • Label: root
    root partition

    Figure 14: root partition

  4. After all partitions are defined, verify your partition configuration is similar to Figure 15.

    Final partition configuration

    Figure 15: Final partition configuration

  5. Select Edit ‣ Apply All Operations.

  6. A dialog box appears asking “Are you sure you want to apply the pending operations?”

  7. Select Apply.

  8. When dialog Applying pending operations is complete, select Close.

  9. Select GParted ‣ Quit.

You are returned to installer.

Manage User

  1. In Required Options, select Manage User.

  2. In User Name, enter a user name.

    Manage User

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

    Note

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

  6. Select Confirm.

    Note

    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.

    Note

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

Optional: Skip to Finish installation.

Telemetry

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 17: 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.

Note

You can always add more bundles later with swupd.

Select Additional Bundles

This option is only available with a valid network connection. Bundle selection is disabled if no network connection exists.

  1. On the Advanced menu, select Select Additional Bundles.

  2. Select your desired bundles.

    Bundle Selection

    Figure 18: Bundle Selection

  3. Select Confirm.

  4. View the bundles that you selected.

    Select Additional Bundles

    Figure 19: Select Additional Bundles

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 20: Assign Hostname

    Note

    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 21: 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 22: Software Updater Configuration

  4. Select Confirm.

Finish installation

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

    Assign Hostname

    Figure 23: Finish installation

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

    Required Options - Incomplete

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

    Note

    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.