Installation¶
SBC hardware
The generic installation documentation focuses on platforms with ISO boot support. Installing RKOS on SBC hardware like the Raspberry Pi might require a manual installation.
The provided boot images contain scripts for installing RKOS on a local block device. The system needs to be booted from the downloaded RKOS image. Most RKOS images are provided with the two kernel flavors lts and stable. It is recommended to use the lts kernel flavor, use standard if you need to support new hardware or triage kernel bugs.
Install to Disk¶
The rkos-install script can be used to install RKOS to a block device. Be aware that this script will wipe any content on the target disk. The script will create the following GPT partitioning scheme after wiping the disk (depends on the disk size):
| ID | Size | Type | Label |
|---|---|---|---|
| 1 | 128 MiB | EFI System | efi |
| 2 | 6 GiB | VFAT | rkos-sys-1 |
| 3 | 6 GiB | VFAT | rkos-sys-2 |
| 4 | 4 GiB | VFAT | rkos-config |
| ID | Size | Type | Label |
|---|---|---|---|
| 1 | 128 MiB | EFI System | efi |
| 2 | 4 GiB | VFAT | rkos-sys-1 |
| 3 | 4 GiB | VFAT | rkos-sys-2 |
| 4 | 3 GiB | VFAT | rkos-config |
| ID | Size | Type | Label |
|---|---|---|---|
| 1 | 128 MiB | EFI System | efi |
| 2 | 3.75 GiB | VFAT | rkos-sys-1 |
| 3 | 3.75 GiB | VFAT | rkos-sys-2 |
| 4 | available space | VFAT | rkos-config |
| ID | Size | Type | Label |
|---|---|---|---|
| 1 | 128 MiB | EFI System | efi |
| 2 | 1.75 GiB | VFAT | rkos-sys-1 |
| 3 | 1.75 GiB | VFAT | rkos-sys-2 |
| 4 | available space | VFAT | rkos-config |
To start the installation you need to specify the mount point of the boot media and the target block device where the RKOS partitions will be created:
usage: rkos-install <SRC> <DEV>
Wipes all data from DEV, creates GPT partitioning for RKOS UEFI based
dual boot partition schema and copies the mounted RKOS image from SRC
to DEV.
SRC must be a mount point.
DEV must be a block device.
Options:
-s OPT Serial kernel console setting:
off - do not enable serial console
on - configure detected serial console
ttySx,115200 - tty+speed setting
-h Show this help.
-v Verbose mode. Display whats going on.
The target device will be wiped!
The rkos-install script will wipe any data on the target device. Make sure you select the correct device to avoid data loss!
rkos-install /media/cdrom /dev/sda
The install tool will:
- unmount any filesystems on the target deviec
- wipe partition signatures and TRIM the target device
- partitions the target device with the GPT partition scheme described above
- copy the install media files to the
rkos-sys-[12]partitions - build an unified Linux kernel image including initrd and kernel command line
- setup
efibootguard - configure EFI boot entries (optional)
Reboot¶
After installing the software the system needs to be rebooted into the local installation. Remove the install media before rebooting to prevent confusion.