Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/clearlinux/clr-installer
Clear Linux* OS Installer
https://github.com/clearlinux/clr-installer
golang hacktoberfest installer
Last synced: 4 days ago
JSON representation
Clear Linux* OS Installer
- Host: GitHub
- URL: https://github.com/clearlinux/clr-installer
- Owner: clearlinux
- License: gpl-3.0
- Created: 2018-07-20T17:16:35.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-12-11T23:42:39.000Z (22 days ago)
- Last Synced: 2024-12-23T00:06:45.788Z (11 days ago)
- Topics: golang, hacktoberfest, installer
- Language: Go
- Homepage:
- Size: 8.96 MB
- Stars: 95
- Watchers: 9
- Forks: 43
- Open Issues: 75
-
Metadata Files:
- Readme: Readme.md
- Contributing: .github/CONTRIBUTING.md
- License: COPYING
- Security: SECURITY.md
Awesome Lists containing this project
README
# 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](https://clearlinux.org/documentation/clear-linux/concepts/security).
## 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](../master/scripts/developer-image.yaml) as the config file.
```
sudo .gopath/bin/clr-installer --config scripts/developer-image.yaml
```
Refer to [InstallerYAMLSyntax](../master/scripts/InstallerYAMLSyntax.md) 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= bs=4M status=progress
```
> Note: Replace `````` 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
```