Merge branch 'master' of github.com:clearlinux/clear-linux-documentation into rtd-theme

2026-09-03 20:31:31 +00:00 · 2019-05-22 10:15:05 -07:00
parent 979f0c2979 9fa3a0a0e7
commit f180f88dc0
152 changed files with 19335 additions and 7444 deletions
@@ -0,0 +1,496 @@
+.. _bare-metal-install-desktop:
+
+Install |CL-ATTR| from the live desktop
+#######################################
+
+The live desktop allows you to boot |CL-ATTR| in a GNOME desktop without
+modifying the host system, offering the chance to explore developing
+on |CL|. Better yet, launch the |CL| installer to install on your target
+system.
+
+.. contents:: :local:
+   :depth: 1
+
+System requirements
+*******************
+
+Assure that your target system supports the installation:
+
+* :ref:`system-requirements`
+* :ref:`compatibility-check`
+
+Preliminary steps
+*****************
+
+#. `Visit our Downloads page`_.
+
+#. Download the file :file:`clear-<release number>-live-desktop.iso`
+
+   .. note::
+
+      <release-number> is the latest |CL| auto-numbered release.
+
+#. Follow your OS instructions to create a bootable USB drive.
+
+   * :ref:`bootable-usb`
+
+.. _install-on-target-start:
+
+Install from live image
+***********************
+
+After you download and burn the live desktop image on a USB drive, follow
+these steps.
+
+#. Insert the USB drive into an available USB slot.
+
+#. Power on the system.
+
+#. Open the system BIOS setup menu by pressing the :kbd:`F2` key.
+   Your BIOS setup menu entry point may vary.
+
+#. In the setup menu, enable the UEFI boot and set the USB drive as the
+   first option in the device boot order.
+
+#. Save these settings, e.g. :kbd:`F10`, and exit.
+
+#. Reboot the target system.
+
+#. Select :guilabel:`Clear Linux OS` in the boot menu, shown in Figure 1.
+
+   .. figure:: figures/bare-metal-install-desktop-01.png
+      :scale: 100%
+      :alt: Clear Linux OS in boot menu
+
+      Figure 1: Clear Linux OS in boot menu
+
+.. _install-on-target-end:
+
+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**.
+
+#. In the upper right of the top menu bar, select the square icon to view
+   Network settings, shown in Figure 2.
+
+#. Select :guilabel:`Wired Connected` and then :guilabel:`Wired Settings`.
+
+   .. figure:: figures/bare-metal-install-desktop-02.png
+      :scale: 100%
+      :alt: Software icon, Network settings
+
+      Figure 2: Software icon, Network settings
+
+#. View the :guilabel:`Wired` menu to assure that you're target system and
+   installer are connected to a network.
+
+#. Optional: Configure Proxy settings.
+
+   #. To view :guilabel:`Network Proxy`, select its :guilabel:`Gear` icon.
+
+   #. Select from `Automatic`, `Manual` or `Disabled` as desired.
+
+   #. Close the dialogue box.
+
+#. Select the :guilabel:`Gear` icon to view Network settings.
+
+#. If desired, select :guilabel:`Connect automatically`.
+   Select other options as desired.
+
+#. Select :guilabel:`Apply` button to confirm change to settings.
+
+Software
+--------
+
+Optional: Explore |CL| bundles and other software available. Double-click the :guilabel:`Software` icon from the Activities menu, shown in Figure 2.
+
+.. note::
+
+   `Sofware` application is *only intended for exploring* available bundles,
+   applications, and images. Do not attempt to install them.
+
+   Assure there is a network connection before launching `Software`.
+
+Launch the |CL| installer
+=========================
+
+#. After the live desktop image boots, find the |CL| icon in
+   the :guilabel:`Activities` menu at left, shown in Figure 3.
+
+#. Click the icon, :guilabel:`Install Clear Linux OS`.
+
+   .. figure:: figures/bare-metal-install-desktop-02.png
+      :scale: 100%
+      :alt: Install Clear Linux OS icon
+
+      Figure 3: Install Clear Linux OS icon
+
+#. The installer is launched, as shown in Figure 4.
+
+   .. figure:: figures/bare-metal-install-desktop-04.png
+      :scale: 100%
+      :alt: |CL| Desktop Installer
+
+      Figure 4: |CL| OS Desktop Installer
+
+#. In :guilabel:`Select Language`, select a language from the options, or
+   type your preferred language in the search bar.
+
+#. Select :guilabel:`Next`.
+
+
+.. _incl-bare-metal-beta-start:
+
+Minimum installation requirements
+*********************************
+
+To fulfill minimum installation requirements, complete the
+`Required options`_. We also recommend completing `Advanced options`_.
+
+.. note::
+
+   * The :kbd:`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.
+
+|CL| Desktop Installer
+**********************
+
+The |CL| Desktop Installer Main Menu appears as shown in Figure 5. To meet
+the minimum requirements, enter values in all submenus for the
+:guilabel:`Required options`. After you complete them, your selections appear
+below submenus and a checkmark appears at right.
+
+.. figure:: figures/bare-metal-install-desktop-05.png
+   :scale: 100%
+   :alt: Clear Linux OS Desktop Installer - Main Menu
+
+   Figure 5: Clear Linux OS Desktop Installer - Main Menu
+
+Navigation
+**********
+
+* Use the :kbd:`mouse` to navigate or select options.
+
+* Use :kbd:`Tab` key to navigate between :guilabel:`Required options`
+  and :guilabel:`Advanced options`
+
+* Use :kbd:`Up` or :kbd:`Down` arrow keys to navigate submenu list.
+
+* Select :kbd:`Confirm`, or :kbd:`Cancel` in submenus.
+
+Required options
+****************
+
+Select Time Zone
+================
+
+#. From the Main Menu, select :guilabel:`Select Time Zone`. `UTC` is selected
+   by default.
+
+#. In :guilabel:`Select Time Zone`, navigate to the desired time zone.
+   Or start typing the region and then city.
+   (.e.g., :file:`America/Los_Angeles`).
+
+#. Select :guilabel:`Confirm`.
+
+   .. figure:: figures/bare-metal-install-desktop-06.png
+      :scale: 100%
+      :alt: Select System Timezone
+
+      Figure 6: Select System Time Zone
+
+Select Keyboard
+===============
+
+#. From the Main Menu, select :guilabel:`Select Keyboard`.
+
+#. Navigate to your desired keyboard layout. We select "us" for the
+   United States.
+
+#. Select :guilabel:`Confirm`.
+
+   .. figure:: figures/bare-metal-install-desktop-07.png
+      :scale: 100%
+      :alt: Select Keyboard menu
+
+      Figure 7: Select Keyboard menu
+
+Select Installation Media
+=========================
+
+#. From the Main Menu, select :guilabel:`Select Installation Media`.
+
+#. Choose an installation method: `Safe Installation`_ or
+   `Destructive Installation`_.
+
+   .. figure:: figures/bare-metal-install-desktop-08.png
+      :scale: 100%
+      :alt: Select Installation Media
+
+      Figure 8: Select Installation Media
+
+Safe Installation
+-----------------
+Use this method to safely install |CL| on media with available space, or
+alongside existing partitions, and accept the `Default partition schema`_.
+If enough free space exists, safe installation is allowed.
+
+Destructive Installation
+------------------------
+
+Use this method to destroy the contents of the target device, install |CL| on it, and accept the `Default partition schema`_.
+
+Disk encryption
+===============
+
+For greater security, disk encryption is supported using LUKS. Encryption is
+optional.
+
+#. To encrypt the root partition, select :guilabel:`Enable Encryption`,
+   as shown in Figure 9.
+
+   .. figure:: figures/bare-metal-install-desktop-09.png
+      :scale: 100%
+      :alt: Enable Encryption
+
+      Figure 9: Enable Encryption
+
+#. When :guilabel:`Encryption Passphrase` appears, enter a passphrase.
+
+   .. figure:: figures/bare-metal-install-desktop-10.png
+      :scale: 100%
+      :alt: Encryption Passphrase
+
+      Figure 10: Encryption Passphrase
+
+   .. note::
+
+      Minimum length is 8 characters. Maximum length is 94 characters.
+
+#. Enter the same passphrase in the second field.
+
+#. Select :guilabel:`Confirm` in the dialogue box.
+
+   .. note::
+
+      :guilabel:`Confirm` is only highlighted if passphrases match.
+
+#. Select :guilabel:`Confirm` in submenu.
+
+Manage User
+===========
+
+#. In Required Options, select :guilabel:`Manage User`.
+
+#. In :guilabel:`User Name`, enter a user name.
+
+   .. figure:: figures/bare-metal-install-desktop-11.png
+      :scale: 100%
+      :alt: Manage User
+
+      Figure 11: Manage User
+
+#. In :guilabel:`Login`, create a login name. It must start with a letter
+   and can use numbers, hyphens, and underscores. Maximum length is 31
+   characters.
+
+#. In :guilabel:`Password`, enter a password. Minimum length is
+   8 characters. Maximum length is 255 characters.
+
+#. In :guilabel:`Confirm`, enter the same password.
+
+   .. note::
+
+      :guilabel:`Administrator` rights are selected by default.
+      For security purposes, the default user must be assigned as an
+      Administrator.
+
+#. Select :kbd:`Confirm`.
+
+   .. note::
+
+      Select :guilabel:`Cancel` to return to the Main Menu.
+
+Modify User
+-----------
+
+#. In Manager User, select :guilabel:`Manage User`.
+
+#. Modify user details as desired.
+
+#. Select :guilabel:`Confirm` to save the changes you made.
+
+   .. note::
+
+      Optional: Select :guilabel:`Cancel` to return to the Main Menu to
+      revert changes.
+
+Optional: Skip to `Finish installation`_.
+
+Telemetry
+=========
+
+Choose whether to participate in `telemetry`. :ref:`telem-guide` is a |CL|
+feature that reports failures and crashes to the |CL| development
+team for improvements. For more information, see :ref:`telemetry-about`.
+
+#. From :guilabel:`Required Options`, select :guilabel:`Telemetry`.
+
+#. Select :kbd:`Confirm`.
+
+#. If you don't wish to participate, deselect :kbd:`Enable Telemetry`.
+
+#. Select :kbd:`Confirm`.
+
+   .. figure:: figures/bare-metal-install-desktop-12.png
+      :scale: 100%
+      :alt: Enable Telemetry
+
+      Figure 12: Enable Telemetry
+
+Advanced options
+****************
+
+After you complete the `Required options`_, we recommend completing
+:guilabel:`Advanced options`--though they're not required. Doing so
+customizes your development environment, so you're ready to go immediately
+after reboot.
+
+* `Bundle Selection`_
+
+* `Assign Hostname`_
+
+As for bundles, you can always add more later with :ref:`swupd-guide`.
+
+Bundle Selection
+================
+
+#. On the Advanced menu, select :guilabel:`Bundle Selection`
+
+#. Select your desired bundles.
+
+   .. figure:: figures/bare-metal-install-desktop-13.png
+      :scale: 100%
+      :alt: Bundle Selection
+
+      Figure 13: Bundle Selection
+
+#. Select :kbd:`Confirm`.
+
+#. View the bundles that you selected.
+
+   .. figure:: figures/bare-metal-install-desktop-14.png
+      :scale: 100%
+      :alt: Bundle Selections - Advanced Options
+
+      Figure 14: Bundle Selections - Advanced Options
+
+Optional: Skip to `Finish installation`_.
+
+Assign Hostname
+===============
+
+#. In Advanced Options, select :guilabel:`Assign Hostname`.
+
+#. In :guilabel:`Hostname`, enter the hostname only (excluding the domain).
+
+   .. figure:: figures/bare-metal-install-desktop-15.png
+      :scale: 100%
+      :alt: Assign Hostname
+
+      Figure 15: 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.
+
+#. Navigate to :kbd:`Confirm` until highlighted.
+
+#. Select :kbd:`Confirm`.
+
+Optional: Skip to `Finish installation`_.
+
+Finish installation
+*******************
+
+#. When you are satisfied with your installation configuration, select
+   :guilabel:`Install`.
+
+   .. figure:: figures/bare-metal-install-desktop-16.png
+      :scale: 100%
+      :alt: Assign Hostname
+
+      Figure 16: Finish installation
+
+   .. note:
+
+      All checkmarks must be visible in :guilabel:`Required Options` for you to select :guilabel:`Install`.
+
+#. If you do not enter a selection for all :guilabel:`Required Options`,
+   the :guilabel:`Install` button remains greyed out, as shown
+   in Figure 17. Return to `Required Options`_ and make selections.
+
+
+   .. figure:: figures/bare-metal-install-desktop-17.png
+      :scale: 100%
+      :alt: Required Options - Incomplete
+
+      Figure 17: Required Options - Incomplete
+
+#. After installation is complete, select :guilabel:`Exit`.
+
+#. Shut down the target system.
+
+#. Remove the USB or any installation media.
+
+#. Power on your system.
+
+   .. note::
+
+      Allow time for the graphical login to appear. A login prompt shows the administrative user that you created.
+
+#. Log in as the adminstrative user.
+
+Congratulations. You successfully installed |CL|.
+
+Default partition schema
+========================
+
+Table 1 shows the defult partition schema with the exception of root,
+which varies.
+
+.. list-table:: **Table 1. Disk Partition Setup**
+   :widths: 33, 33, 33
+   :header-rows: 1
+
+   * - FileSystem
+     - Mount Point
+     - Minimum size
+   * - ``VFAT``
+     - /boot
+     - 150M
+   * - ``swap``
+     -
+     - 256MB
+   * - ``root``
+     - /
+     - *Size depends upon use case/desired bundles.*
+
+Next steps
+**********
+
+:ref:`guides`
+
+.. _Visit our downloads page: https://clearlinux.org/downloads
+.. _Autoproxy: https://clearlinux.org/features/autoproxy
+
@@ -1,17 +1,12 @@
-.. _bare-metal-install-beta:
+.. _bare-metal-install-server:

-Install |CL-ATTR| from the live desktop beta image
-##################################################
+Install |CL-ATTR| on bare metal with live server
+################################################

-The live desktop beta image allows you to boot |CL-ATTR| into a GNOME
-desktop without modifying the host system. Using the live image, you can
-explore the possibilities of developing with |CL|.
+These instructions guide you through installing |CL-ATTR| on bare metal from a bootable USB drive using a live server image.

-You can also launch the installer to install |CL| on your target system.
-If you proceed with installation, this document assumes you follow the
-`Recommended options`_.
-
-.. contents:: :local:
+.. contents::
+   :local:
   :depth: 1

 System requirements
@@ -22,101 +17,103 @@ Assure that your target system supports the installation:
 * :ref:`system-requirements`
 * :ref:`compatibility-check`

-Preliminary steps
-*****************
+Download the latest |CL| live server image
+******************************************

-#. `Navigate to the image directory`_.
-
-#. Download the file :file:`clear-<release number>-live-desktop-beta.img.xz`
-
-   .. note::
-
-      <release-number> is the latest |CL| auto-numbered release.
+Get the latest |CL| installer image from the `downloads page`_. Look for the
+:file:`clear-[version number]-live-server.iso` file.

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

   * :ref:`bootable-usb`

-.. _install-on-target-start:
+#. After downloading the image, verify and decompress the file per your OS.

-Install from live image
-***********************
+Install |CL| on your target system
+**********************************

-After you've downloaded and burned the live desktop image on a
-USB drive, follow these steps.
+Ensure that your system is configured to boot UEFI. The installation method
+described below requires a wired Internet connection with DHCP.
+
+.. note::
+
+   Alternatively, you can install |CL| over a wireless connection by first
+   using `nmtui`. Follow the `nmtui` instructions shown in Figure 2.
+
+Follow these steps to install |CL| on the target system:

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

 #. Power on the system.

 #. Open the system BIOS setup menu by pressing the :kbd:`F2` key.
+   Your BIOS setup menu entry point may vary.

-   .. note::
-
-      Your BIOS setup menu entry point may vary.
-
-#. In the setup menu, enable the UEFI boot and set the USB drive as the
-   first option in the device boot order.
+#. In the setup menu, enable the UEFI boot and set the USB drive as the first
+   option in the device boot order.

 #. Save these settings and exit.

 #. Reboot the target system.

-.. _install-on-target-end:
+#. This action launches the |CL| installer boot menu, shown in figure 1.

-Launch the installer
-====================
+   .. figure:: figures/bare-metal-install-server-01.png
+      :scale: 100%
+      :alt: Clear Linux OS Installer boot menu

-#. After the |CL| live desktop image boots, select the :guilabel:`Activities`   menu in the upper left.
+      Figure 1: Clear Linux OS Installer boot menu

-#. Select the icon, :guilabel:`Install Clear Linux OS`, shown in Figure 1.
+#. With :guilabel:`Clear Linux OS` highlighted, select :kbd:`Enter`.

-   .. figure:: figures/bare-metal-install-beta-1.png
-      :scale: 50 %
-      :alt: Install Clear Linux OS icon
+Launch the |CL| Installer
+*************************

-      Figure 1: Install Clear Linux OS icon
+#. At the :guilabel:`login` prompt, enter :command:`root`.

-#. Upon selecting the icon, the installer is launched, as shown in Figure 2.
+#. Follow the onscreen instructions, shown in Figure 2, and
+   enter a temporary password.

-   .. figure:: figures/bare-metal-install-beta-2.png
-      :scale: 50 %
-      :alt: Clear Linux OS Installer
+   .. figure:: figures/bare-metal-install-server-02.png
+      :scale: 100%
+      :alt: root login

-      Figure 2: Clear Linux OS Installer
+      Figure 2: root login

-.. _incl-bare-metal-beta-start:
+#. At the :guilabel:`root` prompt, enter :command:`clr-installer` and
+   press :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-03.png
+      :scale: 100%
+      :alt: clr-installer command
+
+      Figure 3: clr-installer command

 Minimum installation requirements
 *********************************

 To fulfill minimum installation requirements, complete the
-`Required options`_. We also encourage you to install `Recommended options`_ for a full desktop experience. `Advanced options`_ are optional.
+`Required options`_. While not required, we encourage you to apply the
+`Recommended options`_. `Advanced options`_ are optional.

 .. note::

   * The :kbd:`Install` button is **only highlighted after** you complete
     `Required options`_.

-   * You must choose whether or not to participate in :ref:`telem-guide`
-     before you can finish installation.
-
-   * You may `Test Network Settings`_ before installation
-     `Configure Network Interfaces`_. Assure a *Success* message appears before installation.
-
 Main Menu
 *********
-The |CL| Installer Main Menu appears as shown in Figure 3.
+The |CL| Installer Main Menu appears as shown in Figure 4.

-.. figure:: figures/bare-metal-install-beta-3.png
+.. figure:: figures/bare-metal-install-server-04.png
   :scale: 100%
-   :alt: Clear Linux OS Installer Main Menu
+   :alt: Clear Linux OS Installer

-   Figure 3: Clear Linux OS Installer Main Menu
+   Figure 4: Clear Linux OS Installer

 The |CL| Installer Main Menu has two tabs: :guilabel:`[R] Required options`
 and :guilabel:`[A] Advanced options`. Navigate between tabs using the arrow
-keys or these shortcut keys:
+these shortcut keys:

 * :kbd:`Shift+A` for :guilabel:`[A] Advanced options`
 * :kbd:`Shift+R` for :guilabel:`[R] Required options`
@@ -140,50 +137,40 @@ Required options
 Choose Timezone
 ===============

-#. From the Main Menu, select :guilabel:`Choose Timezone`.
+#. From the Main Menu, navigate to :guilabel:`Choose Timezone`.
+   `UTC` is the default.

-#. Select :kbd:`Enter` to continue.
+#. Select :kbd:`Enter`.

-#. In :guilabel:`Select System Timezone`, navigate to
-   the desired timezone.
+#. In :guilabel:`Select System Timezone`, use :kbd:`Up/Down` arrows
+   navigate to the desired timezone.

-#. Use :kbd:`Tab` to navigate to :guilabel:`Confirm`.
+.. todo: User need only select Enter; can only select Confirm with mouse.

-#. Select :kbd:`Enter` to :kbd:`Confirm`.
+#. Press :kbd:`Enter` to confirm.

-   .. note::
-
-      Select :guilabel:`Cancel` to restore the previously defined value and
-      return to the Main Menu.
-
-   .. figure:: figures/bare-metal-install-beta-4.png
+   .. figure:: figures/bare-metal-install-server-05.png
      :scale: 100%
      :alt: Select System Timezone

-      Figure 4: Select System Timezone
+      Figure 5: Select System Timezone

 Choose Language
 ===============

-#. From the Main Menu, select :guilabel:`Choose Language`.
+#. From the Main Menu, navigate to :guilabel:`Choose Language`.

 #. Select :kbd:`Enter`.

 #. In :guilabel:`Select System Language`, navigate to your desired language.

-#. Select :kbd:`Tab` to highlight :kbd:`Confirm`.
+#. Press :kbd:`Enter` to confirm.

-#. Select :kbd:`Enter` to :kbd:`Confirm`.
-
-   .. note::
-
-      Select :guilabel:`Cancel` to restore the previously defined value and return to the Main Menu.
-
-   .. figure:: figures/bare-metal-install-beta-5.png
+   .. figure:: figures/bare-metal-install-server-06.png
      :scale: 100%
      :alt: Select System Language

-      Figure 5: Select System Language
+      Figure 6: Select System Language

 Configure the Keyboard
 ======================
@@ -194,135 +181,104 @@ Configure the Keyboard

 #. In :guilabel:`Select Keyboard`, navigate to the desired option.

-#. In :guilabel:`Test keyboard`, type text to assure that the keys map to
-   your keyboard.
-
-#. Select :kbd:`Tab` to highlight :guilabel:`Confirm`.
-
 #. Select :kbd:`Enter` to :kbd:`Confirm`.

-   .. note::
+#. Optional: In :guilabel:`Test keyboard`, type text to assure
+   that the keys map to your keyboard.

-      Select :guilabel:`Cancel` to restore the previously defined value and return to the Main Menu.
-
-   .. figure:: figures/bare-metal-install-beta-6.png
+   .. figure:: figures/bare-metal-install-server-07.png
      :scale: 100%
      :alt: Select Keyboard menu

-      Figure 6: Select Keyboard menu
+      Figure 7: Select Keyboard menu

 Configure Installation Media
 ============================

 #. From the Main Menu, select :guilabel:`Configure Installation Media`.

-#. Choose an installation method: `Safe Installation`_;
-   `Destructive Installation`_; or `Advanced Configuration`_
+#. Choose an installation method:
+   * `Safe Installation`_
+   * `Destructive Installation`_
+   * `Advanced Configuration`_


-   .. figure:: figures/bare-metal-install-beta-7.png
+   .. figure:: figures/bare-metal-install-server-08.png
      :scale: 100%
      :alt: Select Installation Media

-      Figure 7: Select Installation Media
+      Figure 8: Select Installation Media
+
+#. Select :guilabel:`Rescan Media` to show available installation targets.
+
+.. todo: Revise below section to match the dev-gui-00

 Safe Installation
 -----------------

-Use this method to safely install |CL| on media with available space,
-or alongside existing partitions, and accept the recommended partitioning
-schema. If an unallocated partition exists with enough space, safe
-installation is allowed.
-
-If a warning message appears that no media or space is available:
-
- Verify that target media has enough unallocated disk space
- Confirm target media is properly connected or mounted
- Review the size of existing partitions on the target media:
-
-  - Linux\* OS: :command:`lsblk -a`
-  - Windows\* OS:  :command:`diskpart`, then :command:`list disk`
-  - macOS\* platform: :command:`diskutil list`
+Use this method to safely install |CL| on media with available space, or
+alongside existing partitions, and accept the `Default partition schema`_.
+If enough free space exists, safe installation is allowed. See also
+`Troubleshooting`_ below.

 Destructive Installation
 ------------------------

-Use this method to destroy the contents of the target device, install |CL|,
-and accept the recommended partitioning schema. If no safe options exist,
-:guilabel:`Destructive Installation` will appear by default.
+Use this method to destroy the contents of the target device, install |CL|
+on it, and accept the `Default partition schema`_.

 .. note::

   From the :guilabel:`Select Installation Media` menu, select
-   :guilabel:`Enable Encryption` to encrypt the root filesystem for either option above. See also `Disk encryption`_ for more information.
-
-Partition minimum requirements
-------------------------------
-
-To add partitions manually, see `Advanced configuration`_ below and create
-partitions per requirements in Table 1.
-
-.. list-table:: **Table 1. Disk Partition Setup: Minimum requirements**
-   :widths: 33, 33, 33
-   :header-rows: 1
-
-   * - FileSystem
-     - Mount Point
-     - Minimum size
-   * - ``VFAT``
-     - /boot
-     - 150M
-   * - ``swap``
-     -
-     - 256MB
-   * - ``root``
-     - /
-     - *Size depends upon use case/desired bundles.*
+   :guilabel:`Enable Encryption` to encrypt the root filesystem for either
+   option above. See also `Disk encryption`_ for more information.

 Advanced Configuration
 ----------------------

-Use this method to manually configure partitions. Partitions
-must meet `Partition minimum requirements`_.
-You may also choose `Disk encryption`_ during partitioning.
+Use this method to manually configure partitions. These must meet
+`Default partition schema`_. You may also choose `Disk encryption`_ during
+configuration of each partition.

 .. note::

-   Advanced Configuration is available in the installer versions 1.2.0 and above.
+   `Advanced Configuration` is available in the installer versions 1.2.0 and
+   above.

-#. In :guilabel:`Advanced Configuration`, press
-   :kbd:`Enter` to activate editing.
+#. From :guilabel:`Select Installation Media`, shown in Figure 8 above,
+   select :guilabel:`Advanced Configuration`.

-   .. figure:: figures/bare-metal-install-beta-8.png
+#. In :guilabel:`Advanced Configuration`, navigate to :file:`/dev/sda`
+   and then press :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-09.png
      :scale: 100%
      :alt: Advanced configuration menu

-      Figure 8: Advanced configuration menu
+      Figure 9: Advanced configuration menu

-#. Choose one of these options:
+#. Choose a partition method:

-   :guilabel:`Auto Partition`
+   * :guilabel:`Auto Partition` Select this option to accept the
+     `Default partition schema`_.

-   #. Select this option to accept the recommended partitioning schema.
+     #. Navigate to and press :guilabel:`Confirm`.

-   #. Navigate to and press :guilabel:`Confirm`.
+     #. Continue with installation configuration. Jump to `Telemetry`_.

-   #. Continue with installation configuration.
-
-   :guilabel:`Manual Partition`
-
-   #. Continue below.
+   * `Manual Partition`_ Continue below.

 Manual Partition
 ----------------

 We provide a simple example below.

-#. Navigate to the unallocated media (e.g.,`sdb1`) until highlighted.
+#. Navigate to the unallocated media (e.g.,`/dev/sda`) until highlighted, as
+   shown in Figure 9.

-#. Select :guilabel:`Enter` to edit the partition.
+#. Press :guilabel:`Enter` to edit the partition.

-#. The :guilabel:`Partition Setup` menu appears, shown in Figure 9.
+#. The :guilabel:`Partition Setup` menu appears, shown in Figure 10.

   .. note::

@@ -331,45 +287,54 @@ We provide a simple example below.
 root partition
 --------------

-We configure the `root` partition as shown in Figure 9.
+#. We configure the `root` partition as shown in Figure 10.
+   Configuration of the `root` partition varies.

-.. figure:: figures/bare-metal-install-beta-9.png
-   :scale: 100%
-   :alt: root partition
+   .. figure:: figures/bare-metal-install-server-10.png
+      :scale: 100%
+      :alt: root partition

-   Figure 9: root partition
+      Figure 10: root partition
+
+#. Navigate to :guilabel:`Add` and press :guilabel:`Enter`.

 boot partition
 --------------

-We configure the `boot` partition as shown in Figure 10.
+#. We configure the `boot` partition as shown in Figure 11.

-.. figure:: figures/bare-metal-install-beta-10.png
-   :scale: 100%
-   :alt: boot partition
+   .. figure:: figures/bare-metal-install-server-11.png
+      :scale: 100%
+      :alt: boot partition

-   Figure 10: boot partition
+      Figure 11: boot partition
+
+#. Navigate to :guilabel:`Add` and press :guilabel:`Enter`.

 swap partition
 --------------

-#. In the :guilabel:`File System` pulldown menu, we select `swap`, and
-   enter its label. We enter the minimum required size (e.g., 256M).
+#. In the :guilabel:`File System` pulldown menu, select `swap`, and
+   enter a label. We enter the minimum required size (e.g., 256M).

-   .. figure:: figures/bare-metal-install-beta-11.png
+   .. figure:: figures/bare-metal-install-server-12.png
      :scale: 100%
      :alt: swap partition

-      Figure 11: swap partition
+      Figure 12: swap partition
+
+#. Navigate to :guilabel:`Add` and press :guilabel:`Enter`.

 #. Next, navigate to :guilabel:`Confirm` and press :guilabel:`Enter`,
-   shown in Figure 12.
+   shown in Figure 13.

-   .. figure:: figures/bare-metal-install-beta-12.png
+   Manual partitioning is complete.
+
+   .. figure:: figures/bare-metal-install-server-13.png
      :scale: 100%
      :alt: Final configuration of disk partitions

-      Figure 12: Final configuration of disk partitions
+      Figure 13: Final configuration of disk partitions

 #. You may skip to the `Telemetry`_ section below.

@@ -383,18 +348,17 @@ example below. Encryption is optional.
 Encryption Passphrase
 ---------------------

-|CL| uses a single passphrase for encrypted partitions. Additional or
-different keys may be configured post-installation using the ``cryptsetup``
-tool.
+|CL| uses a single passphrase for encrypted partitions. Additional keys may
+be configured post-installation using the ``cryptsetup`` tool.

 #. Optional: Select :guilabel:`[X] Encrypt` to encrypt the root partition,
-   as shown in Figure 13.
+   as shown in Figure 14.

-   .. figure:: figures/bare-metal-install-beta-13.png
+   .. figure:: figures/bare-metal-install-server-14.png
      :scale: 100%
      :alt: Encrypt partition

-      Figure 13: Encrypt partition
+      Figure 14: Encrypt partition

 #. The :guilabel:`Encryption Passphrase` dialogue appears.

@@ -402,11 +366,11 @@ tool.

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

-   .. figure:: figures/bare-metal-install-beta-14.png
+   .. figure:: figures/bare-metal-install-server-15.png
      :scale: 100%
      :alt: Encryption Passphrase

-      Figure 14: Encryption Passphrase
+      Figure 15: Encryption Passphrase

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

@@ -419,10 +383,11 @@ tool.
 Telemetry
 =========

-To fulfill :guilabel:`Required options`, choose whether to participate in
-the `telemetry option`_. :ref:`telem-guide` is a |CL| feature that reports
-failures and crashes to the |CL| development team for improvements. For more
-detailed information, visit our :ref:`telemetry-about` page.
+:ref:`telem-guide` is a |CL| feature that reports failures and crashes to
+the |CL| development team for improvements. For more detailed information,
+visit our :ref:`telemetry-about` page.
+
+Select your desired option on whether to participate in `telemetry`.

 #. In the Main Menu, navigate to :guilabel:`Telemetry` and select
   :kbd:`Enter`.
@@ -431,28 +396,21 @@ detailed information, visit our :ref:`telemetry-about` page.

 #. Select :kbd:`Enter` to confirm.

-   .. figure:: figures/bare-metal-install-beta-15.png
+   .. figure:: figures/bare-metal-install-server-16.png
      :scale: 100%
      :alt: Enable Telemetry

-      Figure 15: Enable Telemetry
+      Figure 16: Enable Telemetry

 Recommended options
 *******************

 After you complete the `Required options`_, we highly recommend completing
-a few `Advanced options`_ at minimum:
+these selected `Advanced options`_ at minimum:

-* `Bundle Selection`_ Add basic utlities and tools:
-
-  * :file:`desktop-autostart`
-  * :file:`user-basic`
-
-* `User Manager`_ Assign a new user with administrative rights
+* `Manage User`_ Assign a new user with administrative rights
 * `Assign Hostname`_ Simplify your development environment

-This document assumes you follow these additional steps.
-
 Skip to finish installation
 ===========================

@@ -488,22 +446,22 @@ interface settings are automatically applied.

   .. note:: Multiple network interfaces may appear.

-   .. figure:: figures/bare-metal-install-beta-16.png
+   .. figure:: figures/bare-metal-install-server-17.png
      :scale: 100%
      :alt: Configure Network Interfaces

-      Figure 16: Configure Network Interfaces
+      Figure 17: Configure Network Interfaces

 #. Notice :guilabel:`Automatic / dhcp` is selected by default (at bottom).

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

-   .. figure:: figures/bare-metal-install-beta-17.png
+   .. figure:: figures/bare-metal-install-server-18.png
      :scale: 100%
      :alt: Network interface configuration

-      Figure 17: Network interface configuration
+      Figure 18: Network interface configuration

 #. Navigate to the appropriate fields and assign the desired
   network configuration.
@@ -539,11 +497,11 @@ instruction.

 #. Navigate to the field :guilabel:`HTTPS Proxy`.

-   .. figure:: figures/bare-metal-install-beta-18.png
+   .. figure:: figures/bare-metal-install-server-19.png
      :scale: 100%
      :alt: Configure the network proxy

-      Figure 18: Configure the network proxy
+      Figure 19: Configure the network proxy

 #. Enter the desired proxy address and port using conventional syntax,
   such as: \http://address:port.
@@ -561,13 +519,13 @@ Test Network Settings
 To manually assure network connectivity before installing |CL|,
 select :guilabel:`Test Network Settings` and select :guilabel:`Enter`.

-A progress bar appears as shown in Figure 19.
+A progress bar appears as shown in Figure 20.

-.. figure:: figures/bare-metal-install-beta-19.png
+.. figure:: figures/bare-metal-install-server-20.png
   :scale: 100%
   :alt: Testing Networking dialogue

-   Figure 19: Testing Networking dialogue
+   Figure 20: Testing Networking dialogue

 .. note::

@@ -585,41 +543,36 @@ Bundle Selection

 #. Select :kbd:`Spacebar` to select the checkbox for each desired bundle.

-#. We recommend adding :file:`desktop-autostart` and :file:`user-basic`.
-
-   .. figure:: figures/bare-metal-install-beta-20.png
+   .. figure:: figures/bare-metal-install-server-21.png
      :scale: 100%
      :alt: Bundle Selection

-      Figure 20: Bundle Selection
+      Figure 21: Bundle Selection

-   .. note::
+#. Optional: To start developing with |CL|, we recommend
+   adding :file:`os-clr-on-clr`.

-      The default bundle choices and selections differ between the
-      :file:`clear-<XXXXX>.live-desktop-beta.img` and the
-      :file:`clear-<XXXXX>.installer.img`.
-
-#. Select :kbd:`Confirm` or :kbd:`Cancel`.
+#. Navigate to and select :kbd:`Confirm`.

   You are returned to the :guilabel:`Advanced options` menu.

 Optional: Skip to `Finish installation`_.

-User Manager
-============
+Manage User
+===========

 Add New User
 ------------

-#. In Advanced Options, select :guilabel:`User Manager`.
+#. In Advanced Options, select :guilabel:`Manage User`.

-#. Select :guilabel:`Add New User` as shown in Figure 21.
+#. Select :guilabel:`Add New User` as shown in Figure 22.

-   .. figure:: figures/bare-metal-install-beta-21.png
+   .. figure:: figures/bare-metal-install-server-22.png
      :scale: 100%
      :alt: Add New User, User Name

-      Figure 21: Add New User
+      Figure 22: Add New User

 #. Optional: Enter a :guilabel:`User Name`.

@@ -627,11 +580,11 @@ Add New User

      The User Name must be alphanumeric and can include spaces, commas, or hyphens. Maximum length is 64 characters.

-   .. figure:: figures/bare-metal-install-beta-22.png
+   .. figure:: figures/bare-metal-install-server-23.png
      :scale: 100%
      :alt: User Name

-      Figure 22: User Name
+      Figure 23: User Name

 #. Enter a :guilabel:`Login`.

@@ -645,7 +598,7 @@ Add New User

      Minimum length is 8 characters. Maximum length is 255 characters.

-#. In :guilabel:`Retype`, enter the same password.
+#. In :guilabel:`Confirm`, enter the same password.

 #. Optional: Navigate to the :guilabel:`Administrative` checkbox and select
   :kbd:`Spacebar` to assign administrative rights to the user.
@@ -654,31 +607,25 @@ Add New User

      Selecting this option enables sudo privileges for the user.

-   .. figure:: figures/bare-metal-install-beta-23.png
-      :scale: 100%
-      :alt: Administrative rights
-
-      Figure 23: Administrative rights
-
 #. Select :kbd:`Confirm`.

   .. note::

      If desired, select :guilabel:`Reset` to reset the form.

-#. In :guilabel:`User Manager`, navigate to :guilabel:`Confirm`.
+#. In :guilabel:`Manage User`, navigate to :guilabel:`Confirm`.

 #. With :guilabel:`Confirm` highlighted, select :kbd:`Enter`.

 Modify / Delete User
 --------------------

-#. In User Manager, select :guilabel:`Tab` to highlight the user, as shown
-   in Figure 24.
+#. In :guilabel:`Manage User`, navigate to the user you wish
+   to modify until highlighted, as shown in Figure 24.

 #. Select :kbd:`Enter` to modify the user.

-   .. figure:: figures/bare-metal-install-beta-24.png
+   .. figure:: figures/bare-metal-install-server-24.png
      :scale: 100%
      :alt: Modify User

@@ -686,9 +633,6 @@ Modify / Delete User

 #. Modify user details as desired.

-   Optional: To delete the user, navigate to the :guilabel:`Delete`
-   button and select :kbd:`Enter`
-
 #. Navigate to :kbd:`Confirm` until highlighted.

   .. note::
@@ -697,7 +641,20 @@ Modify / Delete User

 #. Select :guilabel:`Confirm` to save the changes you made.

-You are returned to the User Manager menu.
+#. Optional: In :guilabel:`Modify User`, to delete the user, navigate to
+   the :guilabel:`Delete` button and select :kbd:`Enter`.
+
+   .. figure:: figures/bare-metal-install-server-25.png
+      :scale: 100%
+      :alt: Delete User
+
+      Figure 25: Delete User
+
+You are returned to :guilabel:`Manage User`.
+
+#. Navigate to :kbd:`Confirm` until highlighted.
+
+#. Select :guilabel:`Enter` to complete :guilabel:`Manage User` options.

 Optional: Skip to `Finish installation`_.

@@ -714,18 +671,18 @@ new kernel.

 #. Select :kbd:`Enter`.

-#. To add or remove arguments, choose one of the following options.
-
-   .. figure:: figures/bare-metal-install-beta-25.png
+   .. figure:: figures/bare-metal-install-server-26.png
      :scale: 100%
      :alt: kernel command line

-      Figure 25: kernel command line
+      Figure 26: kernel command line

-#. To add arguments, enter the argument in :guilabel:`Add Extra Arguments`.
+#. Choose from the following options.

-#. To remove an existing argument, enter the argument in
-   :guilabel:`Remove Arguments`.
+   * To add arguments, enter the argument in :guilabel:`Add Extra Arguments`.
+
+   * To remove an argument, enter the argument in
+     :guilabel:`Remove Arguments`.

 #. Select :kbd:`Confirm`.

@@ -735,19 +692,19 @@ Kernel Selection
 ================

 #. Select a kernel option. By default, the latest kernel release is
-   selected. Native kernel is shown in Figure 26.
+   selected. Native kernel is shown in Figure 27.

-#. To select a differnt kernel, navigate to it using :guilabel:`Tab`.
+#. To select a different kernel, navigate to it using :guilabel:`Tab`.

-   .. figure:: figures/bare-metal-install-beta-26.png
+   .. figure:: figures/bare-metal-install-server-27.png
      :scale: 100%
      :alt: Kernel selection

-      Figure 26: Kernel selection
+      Figure 27: Kernel selection

 #. Select :kbd:`Spacebar` to select the desired option.

-#. Select :kbd:`Confirm`.
+#. Navigate to :kbd:`Confirm` and select :kbd:`Enter`.

 Optional: Skip to `Finish installation`_.

@@ -762,11 +719,11 @@ If you have your own custom mirror of |CL|, you can add its URL.

 #. Select :kbd:`Confirm`.

-   .. figure:: figures/bare-metal-install-beta-27.png
+   .. figure:: figures/bare-metal-install-server-28.png
      :scale: 100%
      :alt: Swupd Mirror

-      Figure 27: Swupd Mirror
+      Figure 28: Swupd Mirror

 Optional: Skip to `Finish installation`_.

@@ -783,12 +740,11 @@ Assign Hostname
      alphanumeric character but may also contain hyphens. Maximum length of
      63 characters.

-   .. figure:: figures/bare-metal-install-beta-28.png
+   .. figure:: figures/bare-metal-install-server-29.png
      :scale: 100%
      :alt: Assign Hostname

-      Figure 28: Assign Hostname
-
+      Figure 29: Assign Hostname

 #. Navigate to :kbd:`Confirm` until highlighted.

@@ -799,47 +755,101 @@ Optional: Skip to `Finish installation`_.
 Automatic OS Updates
 ====================

-In the rare case that you need to disable automatic software updates,
-follow the onscreen instructions shown in Figure 29.
+Automatical OS updates are enabled by default. In the rare case that you
+need to disable automatic software updates, follow the onscreen instructions,
+shown in Figure 30.

 #. In Advanced Options, select :guilabel:`Automatic OS Updates`.

 #. Select the desired option.

-   .. figure:: figures/bare-metal-install-beta-29.png
+   .. figure:: figures/bare-metal-install-server-30.png
      :scale: 100%
      :alt: Automatic OS Updates

-      Figure 29: Automatic OS Updates
+      Figure 30: Automatic OS Updates

 You are returned to the :guilabel:`Main Menu`.

+Save Configuration Settings
+===========================
+
+#. In Advanced Options, select :guilabel:`Save Configuration Settings`.
+
+#. A dialogue box shows the installation configuration was saved to
+   :file:`clr-installer.yaml`
+
+   .. figure:: figures/bare-metal-install-server-31.png
+      :scale: 100%
+      :alt: Automatic OS Updates
+
+      Figure 31: Automatic OS Updates
+
+#. Use the :file:`clr-installer.yaml` file to install |CL|, with the same
+   configuration, on multiple targets.
+
 Finish installation
 *******************

 #. When you are satisfied with your installation configuration, navigate to
   :guilabel:`Install` and select :kbd:`Enter`.

+   .. figure:: figures/bare-metal-install-server-32.png
+      :scale: 100%
+      :alt: Select Install
+
+      Figure 32: Select Install
+
 #. Select :guilabel:`reboot`.

   .. note::

-      If you do not perform `Recommended options`_, upon rebooting, a
-      :file:`login:` prompt will appear. At the prompt, enter `root` and change your password immediately.
+      If you do not assign an administrative user, upon rebooting,
+      enter `root` and set the root password immediately.

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

-   .. note::
+Default partition schema
+========================

-      Allow time for the graphical login to appear. This shows the administrative user that you created in `Recommended options`_.
+To add partitions manually, see `Advanced configuration`_ below, and create
+partitions per requirements in Table 1.

-#. Log in as the adminstrative user.
+.. list-table:: **Table 1. Disk Partition Setup**
+   :widths: 33, 33, 33
+   :header-rows: 1

-Next steps
-**********
+   * - FileSystem
+     - Mount Point
+     - Minimum size
+   * - ``VFAT``
+     - /boot
+     - 150M
+   * - ``swap``
+     -
+     - 256MB
+   * - ``root``
+     - /
+     - *Size depends upon use case/desired bundles.*

-:ref:`enable-user-space`
+Troubleshooting
+***************
+
+For Configure Installation Media
+================================
+
+If a warning message appears that no media or space is available after
+entering :guilabel:`Configure Installation Media`:
+
+- Verify that target media has enough free space.
+
+- Confirm the USB is properly connected to and mounted on target media.
+
+- Review the size of existing partitions on the target media:
+
+  - Linux\* OS: :command:`lsblk -a`
+  - Windows\* OS:  :command:`diskpart`, then :command:`list disk`
+  - macOS\* platform: :command:`diskutil list`

-.. _Navigate to the image directory: https://cdn.download.clearlinux.org/image/
 .. _Autoproxy: https://clearlinux.org/features/autoproxy
-.. _telemetry option: https://clearlinux.org/features/telemetry
+.. _downloads page: https://clearlinux.org/downloads
@@ -1,79 +0,0 @@
-.. _bare-metal-install:
-
-Install |CL-ATTR| on bare metal
-###############################
-
-These instructions guide you through the installation of |CL-ATTR|
-on bare metal using a bootable USB drive.
-
-.. contents::
-   :local:
-   :depth: 1
-
-System requirements
-*******************
-
-Assure that your target system supports the installation:
-
-* :ref:`system-requirements`
-* :ref:`compatibility-check`
-
-Download the latest |CL| installer image
-****************************************
-
-Get the latest |CL| installer image from the `downloads page`_. See Figure 1.
-Look for the :file:`clear-[version number]-installer.img.xz` file.
-
-.. figure:: figures/bare-metal-install-1.png
-   :scale: 50%
-   :alt: Visit Downloads
-
-   Figure 1: Visit Downloads
-
-#. Follow your OS instructions to create a bootable USB drive.
-
-   * :ref:`bootable-usb`
-
-#. After downloading the image, verify and decompress the file per your OS.
-
-Install |CL| on your target system
-**********************************
-
-We formatted the previously created USB drive as a UEFI boot device. Our
-target system has a hard drive installed containing a single primary
-partition. The target system needs a wired Internet connection with DHCP.
-
-Follow these steps to install |CL| on the target system:
-
-#. Insert the USB drive into an available USB slot.
-
-#. Power on the system.
-
-#. Open the system BIOS setup menu by pressing the :kbd:`F2` key.
-   Your BIOS setup menu entry point may vary.
-
-#. In the setup menu, enable the UEFI boot and set the USB drive as the first
-   option in the device boot order.
-
-#. Save these settings and exit.
-
-#. Reboot the target system.
-
-#. This action launches the |CL| installer boot menu, shown in figure 2.
-
-   .. figure:: figures/bare-metal-install-2.png
-      :scale: 100%
-      :alt: Clear Linux OS Installer boot menu
-
-      Figure 2: Clear Linux OS Installer boot menu
-
-#. With :guilabel:`Clear Linux OS` highlighted, select :kbd:`Enter`.
-
-Your system will display the |CL| Installer.
-
-.. include:: ../bare-metal-install-beta/bare-metal-install-beta.rst
-   :start-after: incl-bare-metal-beta-start:
-
-
-.. _Autoproxy: https://clearlinux.org/features/autoproxy
-.. _downloads page: https://clearlinux.org/downloads
--- a/Show More
+++ b/Show More