The live desktop beta image allows you to boot Clear Linux* OS into a GNOME desktop without modifying the host system. Using the live image, you can explore the possibilities of developing with Clear Linux OS. You can also launch the new installer and install Clear Linux OS on your target system.

Preliminary steps

  1. Navigate to the image directory.

  2. Download the file clear-<release number>-live-desktop-beta.img.xz

    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’ve downloaded and burned 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.

    Note

    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 and exit.

  6. Reboot the target system.

Launch the installer

  1. After the Clear Linux OS live desktop image boots, select the Activities menu in the upper left.

  2. Select the icon, Install Clear Linux OS, shown in Figure 1.

    Install Clear Linux OS icon

    Figure 1: Install Clear Linux OS icon

  3. Upon selecting the icon, the installer is launched, as shown in Figure 2.

    Clear Linux OS Installer

    Figure 2: Clear Linux OS Installer

Minimum installation requirements

To fulfill minimum installation requirements, complete the Required options. Advanced options are optional.

Note

Required options

Choose Timezone

  1. From the Main Menu, select Choose Timezone.

  2. Select Enter to continue.

  3. In Select System Timezone, navigate to the desired timezone.

  4. Use Tab to navigate to Confirm.

  5. Select Enter to Confirm.

    Note

    Select Cancel to restore the previously defined value and return to the Main Menu.

    Select System Timezone

    Figure 4: Select System Timezone

Choose Language

  1. From the Main Menu, select Choose Language.

  2. Select Enter.

  3. In Select System Language, navigate to your desired language.

  4. Select Tab to highlight Confirm.

  5. Select Enter to Confirm.

    Note

    Select Cancel to restore the previously defined value and return to the Main Menu.

    Select System Language

    Figure 5: Select System Language

Configure the Keyboard

  1. From the Main Menu, select Configure the Keyboard.

  2. Select Enter.

  3. In Select Keyboard, navigate to the desired option.

  4. In Test keyboard, type text to assure that the keys map to your keyboard.

  5. Select Tab to highlight Confirm.

  6. Select Enter to Confirm.

    Note

    Select Cancel to restore the previously defined value and return to the Main Menu.

    Select Keyboard menu

    Figure 6: Select Keyboard menu

Configure Media

  1. From the Main Menu, select Configure Media.

    Note

    Available media appear by default.

  2. Navigate to the desired media until highlighted.

    Configure Media menu

    Figure 7: Configure Media menu

    Note

    Use additional options as necessary during partitioning:

    • Select Revert to cancel changes and revert to the original configuration.
    • Select Rescan to show media connected to the host machine.
  3. Select Enter or Spacebar to select it.

    Two options for partitioning appear.

  4. Select Auto Partition to accept the default configuration, or Add Partition to add partitions manually. See instructions below.

  5. Select Enter to Confirm.

  6. Choose one partitioning option and continue below:

Auto Partition

Auto partition will configure the media to meet the minimum requirements.

  1. Select Auto Partition as shown in Figure 8.

  2. Select Enter or Spacebar to highlight Auto partition.

  3. Select Enter to Confirm.

    This action returns you to the Main Menu.

    Auto Partition

    Figure 8: Auto Partition

  4. You may skip to the Telemetry section below.

Disk encryption

For greater security, disk encryption is supported using LUKS for all partitions except boot on Clear Linux OS. To encrypt a partition, see the example below to encrypt root partition. Encryption is optional.

Encryption Passphrase

Clear Linux OS uses a single passphrase for all encrypted partitions. Therefore, if you turn on encryption for one partition, the same passphrase is used for all partitions. Additional or different keys may be configured post-installation using the cryptsetup tool.

Note

During installation, if you encrypt the root partition first and the swap partition second, after you select encrypt for swap, the Encryption Passphrase dialogue will show the same Passphrase that was assigned to root. Select Confirm and press Enter to use the same Passphrase.

Add Partition

Minimum requirements

To add partitions manually, assign partitions per the minimum requirements shown in Table 1:

Table 1. Disk Partition Setup
FileSystem Mount Point Minimum size
VFAT /boot 150M
swap   256MB
root / Size depends upon use case/desired bundles.
  1. In the Configure Media menu, select Add Partition.

    Note

    To change an existing partition, navigate to the partition, and select Enter.

boot partition

  1. In the File System menu, select Up/Down arrows to select the file system type. See Figure 9.

  2. In Mount Point, enter the /boot partition.

  3. In Size, enter an appropriate size (e.g., 150M) per Table 1.

  4. Navigate to Confirm until highlighted.

  5. Select Enter to confirm.

    boot partition

    Figure 9: boot partition

swap partition

  1. In the File System menu, select Up/Down arrows to select the file system type. See Figure 10.

  2. In Mount Point, the field remains blank.

    Note

    The Mount Point field is disabled.

  3. In Size, enter an appropriate size (e.g., 256MB) per Table 1.

  4. Navigate to Add.

  5. Select Enter to continue.

    swap partition

    Figure 10: swap partition

root partition

  1. In the File System menu, select Up/Down arrows to select the file system type. See Figure 11.

    1. Optional: Select [X] Encrypt to encrypt the partition.

      Encrypt partition

      Figure 11: Encrypt partition

    2. The Encryption Passphrase dialogue appears.

      Note

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

      Encryption Passphrase

      Figure 12: Encryption Passphrase

    3. Enter the same passphrase in the first and second field.

    4. Navigate to Confirm and press Enter.

      Note

      Confirm is only highlighted if passphrases match.

  2. Optional: In [Optional] Label:, enter your desired label for the partition.

  3. In Mount Point, enter /. See Figure 11.

  4. In Size, enter an appropriate size per Table 1.

    Note

    The remaining available space shows by default.

  5. Navigate to Add until highlighted.

  6. Select Enter to continue.

    You are returned to the Configure media menu.

  7. Select Confirm to complete the media selection. See Figure 13.

  8. You are returned to the Configure media menu. Your partitions should be similar to those shown in Figure 13.

    Partitions

    Figure 13: Partitions

  9. Navigate to Confirm until highlighted.

  10. Select Enter to complete adding partitions.

Telemetry

To fulfill the Required options, choose whether or not to participate in telemetry. Telemetry is a Clear Linux OS feature that reports failures and crashes to the Clear Linux OS development team for improvements. For more detailed information, visit our Telemetrics page.

  1. In the Main Menu, navigate to Telemetry and select Enter.

  2. Select Tab to highlight your choice.

  3. Select Enter to confirm.

    Enable Telemetry

    Figure 14: Enable Telemetry

Skip to finish installation

After selecting values for all Required options, you may skip directly to Finish installation.

Otherwise, continue below. In the Main Menu, select Advanced options to configure network interfaces or proxy settings, add bundles, add/manage users, add kernel arguments, and more.

Advanced Options

Configure Network Interfaces

By default, Clear Linux OS is configured to automatically detect the host network interface using DHCP. However, if you want to use a static IP address or if you do not have a DHCP server on your network, follow these instructions to manually configure the network interface. Otherwise, default network interface settings are automatically applied.

Note

If DHCP is available, no user selection may be required.

  1. Navigate to Configure Network Interfaces and select Enter.

  2. Navigate to the network interface you wish to change.

  3. When the desired interface is highlighted, select Enter to edit.

    Note

    Multiple network interfaces may appear.

    Configure Network Interfaces

    Figure 15: Configure Network Interfaces

  4. Notice Automatic / dhcp is selected by default (at bottom).

    Optional: Navigate to the checkbox Automatic / dhcp and select Spacebar to deselect.

    Network interface configuration

    Figure 16: Network interface configuration

  5. Navigate to the appropriate fields and assign the desired network configuration.

  6. To save settings, navigate to Confirm and select Enter.

    Note

    To revert to previous settings, navigate to the Cancel and select Enter.

  7. Upon confirming network configuration, the Testing Networking dialogue appears. Assure the result shows success. If a failure occurs, your changes will not be saved.

  8. Upon confirmation, you are returned to Network interface settings.

  9. Navigate to and select Main Menu.

Optional: Skip to finish installation.

Proxy

Clear Linux OS automatically attempts to detect proxy settings, as described in Autoproxy. If you need to manually assign proxy settings, follow this instruction.

  1. From the Advanced options menu, navigate to Proxy, and select Enter.

  2. Navigate to the field HTTPS Proxy.

    Configure the network proxy

    Figure 17: Configure the network proxy

  3. Enter the desired proxy address and port using conventional syntax, such as: http://address:port.

  4. Navigate to Confirm and select Enter.

  5. To revert to previous settings, navigate to Cancel and select Cancel.

Optional: Skip to finish installation.

Test Network Settings

To manually assure network connectivity before installing Clear Linux OS, select Test Network Settings and select Enter.

A progress bar appears as shown in Figure 18.

Testing Networking dialogue

Figure 18: Testing Networking dialogue

Note

Any changes made to network settings are automatically tested during configuration.

Optional: Skip to finish installation.

Bundle Selection

  1. On the Advanced menu, select Bundle Selection

  2. Navigate to the desired bundle using Tab or Up/Down arrows.

  3. Select Spacebar to select the checkbox for each desired bundle.

    Bundle Selection

    Figure 19: Bundle Selection

  4. Select Confirm or Cancel.

    You are returned to the Advanced options menu.

Optional: Skip to finish installation.

User Manager

Add New User

  1. In Advanced Options, select User Manager.

  2. Select Add New User as shown in Figure 20.

    Add New User, User Name

    Figure 20: Add New User

  3. Optional: Enter a User Name.

    User Name

    Figure 21: User Name

  4. Enter a Login.

    Note

    The User Login must be alphanumeric and can include hyphens and underscores. Maximum length is 31 characters.

  5. Enter a Password.

  6. In Retype, enter the same password.

  7. Optional: Navigate to the Administrative checkbox and select Spacebar to assign administrative rights to the user.

    Note

    Selecting this option enables sudo privileges for the user.

    Administrative rights

    Figure 22: Administrative rights

  8. Select Confirm.

    Note

    If desired, select Reset to reset the form.

  9. In User Manager, navigate to Confirm.

  10. With Confirm highlighted, select Enter.

Modify / Delete User

  1. In User Manager, select Tab to highlight the user, as shown in Figure 23.

  2. Select Enter to modify the user.

    Modify User

    Figure 23: Modify User

  3. Modify user details as desired.

    Optional: To delete the user, navigate to the Delete button and select Enter

  4. Navigate to Confirm until highlighted.

    Note

    Optional: Select Reset to rest the form.

  5. Select Confirm to save the changes you made.

You are returned to the User Manager menu.

Optional: Skip to finish installation.

Kernel Command Line

For advanced users, Clear Linux OS provides the ability to add or remove kernel arguments. If you want to append a new argument, enter the argument here. This argument will be used every time you install or update a new kernel.

  1. In Advanced Options, select Tab to highlight Kernel Command Line.

  2. Select Enter.

  3. To add or remove arguments, choose one of the following options.

    kernel command line

    Figure 24: kernel command line

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

  5. To remove an existing argument, enter the argument in Remove Arguments.

  6. Select Confirm.

Optional: Skip to finish installation.

Kernel Selection

  1. Select a kernel option. By default, the latest kernel release is selected. Native kernel is shown in Figure 25.

  2. To select a differnt kernel, navigate to it using Tab.

    Kernel selection

    Figure 25: Kernel selection

  3. Select Spacebar to select the desired option.

  4. Select Confirm.

Optional: Skip to finish installation.

Swupd Mirror

If you have your own custom mirror of Clear Linux OS, you can add its URL.

  1. In Advanced Options, select Swupd Mirror.

  2. To add a local swupd mirror, enter a valid URL in Mirror URL:

  3. Select Confirm.

    Swupd Mirror

    Figure 26: Swupd Mirror

Optional: Skip to finish installation.

Assign Hostname

  1. In Advanced Options, select Assign Hostname.

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

    Note

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

    Assign Hostname

    Figure 27: Assign Hostname

  3. Navigate to Confirm until highlighted.

  4. Select Confirm.

Optional: Skip to finish installation.

Automatic OS Updates

In the rare case that you need to disable automatic software updates, follow the onscreen instructions.

  1. In Advanced Options, select Automatic OS Updates.

  2. Select the desired option.

    Automatic OS Updates

    Figure 28: Automatic OS Updates

You are returned to the Main Menu.

Finish installation

  1. When you are satisfied with your installation configuration, navigate to Install and select Enter.

    Note

    Whenever installation is finished, a reboot button appears.

  2. Select reboot.

  3. When the system reboots, remove any installation media present.

Congratulations!

You have successfully installed Clear Linux OS on bare metal using the new installer.