Example: RADPx From Scratch

This example starts with a clean Ubuntu/KDE or terminal workstation where only RadBuild has been installed from RadicalPackages.

Install

sudo apt update
sudo apt install radbuild

Create the Project

mkdir -p ~/radpx-work
radbuild project create ~/radpx-work --non-interactive --template radpx-os-terminal --project-name radpx-terminal
cd ~/radpx-work/radpx-terminal

The template contains an os.radpx system with a Git source checkout, the terminal feature chunks, RADPx packagegroups, and SDK export defaults.

Configure

radbuild menuconfig --settings settings.json
radbuild menuconfig --settings settings.json --enable-packagegroup radpx-networking --resolve-packages --json
radbuild menuconfig --settings settings.json --set-source branch=crimson-v0.1.3 --json

Recommended first-image settings:

{
  "hostname": "radpx",
  "root_password": "radpx",
  "terminal_theme": "radpx-dark",
  "terminal_autocomplete": true,
  "terminal_ncurses": true,
  "terminal_vim": true,
  "network_enabled": true,
  "net_ntp_server": "time.google.com",
  "timezone": "America/Los_Angeles"
}

Build and Run

radbuild build os --settings settings.json --json-events
./artifacts/radpx/x86_64-grub-terminal/run-radpx-vm.sh

Expected artifact layout:

artifacts/radpx/x86_64-grub-terminal/
  radpxkernel-x86-64-grub-terminal.iso
  radpx-rootfs.ext4
  radpx-fat32.img
  run-radpx-vm.sh
  radpx-sdk-x86_64-grub-terminal.tar.gz
  SHA256SUMS

Inside the VM, log in with the configured root password and test the staged terminal packages:

login: root
password: radpx
root@radpx:/$ ls /
root@radpx:/$ vi /tmp/hello.txt
root@radpx:/$ date