Clear Linux Installer

Clear Linux OS Security

As the installer is a part of the Clear Linux OS distribution, this program follows the Clear Linux OS Security processes.

Dependencies

In order to build and run clr-installer, install the latest clr-installer bundle:

Text-based only

swupd bundle-add clr-installer

Graphical installer

swupd bundle-add clr-installer-gui

How to test?

Make sure there is free storage space, such as a USB memory stick, unallocated disk, or unallocated (free) partition on a disk and choose it while running the installer.

Clone this repository

git clone https://github.com/clearlinux/clr-installer.git

Build the installer

cd clr-installer && make

Install (installing the installer)

To create a bootable image which will launch the installer, use the installer.yaml as the config file.

sudo .gopath/bin/clr-installer --config scripts/installer.yaml

Refer to InstallerYAMLSyntax for syntax of the config file.

Create a bootable installer on USB media:

sudo .gopath/bin/clr-installer --config scripts/installer.yaml -b installer:<usb device> --iso

Note: Replace <usb device> with the usb's device file as follows:

sudo .gopath/bin/clr-installer --config scripts/installer.yaml -b installer:/dev/sdb --iso

Testing [Run as root]

In order to execute an install the user must run clr-installer as root. It's always possible to tweak configurations and only save the configuration for future use, in that case it's not required to run as root.

Having said that, to run a install do:

sudo .gopath/bin/clr-installer

Multiple Installer Modes

Currently the installer supports 3 modes

1. Mass Installer - using an install descriptor file
2. TUI - a text based user interface
3. GUI - a graphical user interface

Using Mass Installer

In order to use the Mass Installer provide a --config, such as:

sudo .gopath/bin/clr-installer --config ~/my-install.yaml

Using TUI

Call the clr-installer executable without any additional flags, such as:

sudo .gopath/bin/clr-installer

or

sudo .gopath/bin/clr-installer-tui

Using GUI

Call the clr-installer executable without any additional flags, such as:

sudo .gopath/bin/clr-installer-gui

Reboot

For scenarios where a reboot may not be desired, such as when running the installer on a development machine, use the --reboot=false flag as follows:

sudo .gopath/bin/clr-installer --reboot=false

or if using the Mass Installer mode:

sudo .gopath/bin/clr-installer --config=~/my-install.yaml --reboot=false