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

Pre-requisties

We have compiled all the tools you need to start building clr-installer in a single development bundle called clr-installer-dev.

Install it using:

swupd bundle-add clr-installer-dev

cd clr-installer && make

Install (installing the installer)

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

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

Refer to InstallerYAMLSyntax for syntax of the config file.

Create a bootable installer on USB media:

sudo .gopath/bin/clr-installer --config scripts/developer-image.yaml --iso
sudo dd if=installer.iso of=<usb device> bs=4M status=progress

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

sudo dd if=installer.iso of=/dev/sdb bs=4M status=progress

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