The installation script

in this approach we do not dump the image file onto the emmc but instead simply sync the contents of the running system onto newly created filesystems on the emmc. the advantages over legacy dd installation are:

- internet not required - no network connection required and the running system has everything required

- ability to preconfigure - the running image can already be a bit preconfigured and all changes to it will also be synced to emmc (maybe useful when installing on multiple identical systems)

- no uuid conflict - the filesystems on the emmc will get new filesystem uuids and also the labels of the filesystems can be easily adjusted, so no risk of a conflict with a booted rescue system from sd card/usb

- simpler than regular installation

- only arm64 chromebooks supported

Warning. if you don't want you system becoming unbootable in the future, before proceeding with installation it is recommended to first set gbb flags (you can't do this after the installation)

Remember. these steps have to be done from linux booted from usb, not chromeos

Introduction

as of version 0.7.7 velvet tools include vtinstall command

before proceeding with the installation make sure you have version 0.7.7 or higher with the following command

dpkg -l velvet-tools

if you have an ealier version run

sudo apt update sudo apt full-upgrade

if your system doesn't come with velvet tools installed

you can get .deb version from https://github.com/velvet-os/velvet-tools/releases

or

install them via velvet-repo

#add public key curl -sS https://repo.velvet-os.org/repo/velvet_repo.asc | sudo tee -a /etc/apt/trusted.gpg.d/velvet_repo.asc #add source echo "deb [arch=arm64,all] https://repo.velvet-os.org/repo stable main" | sudo tee /etc/apt/sources.list.d/velvet_repo.list #fetch repo content sudo apt update #installe velvet tools sudo apt install velvet-tools

Installation process

1. start by listing all possible installation devices

vtinstall

2. run the following command to install

sudo vtinstall [device]

Warning. make sure your device doesn't go into suspense, this might disrupt the installation

Tip. replace [device] with device you want to install onto like sda or mmcblk0 or mmcblk1

the script should prompt you for confirmation

and after that everything should just happen

after script finished just restart the device and everything should just work

if you encounter any issue with the script

please report them here

Graphical installation (experimental)

there exist also *experimental* graphical wrapper around this command

which serves the exact same purpose as vtinstall and is just fancy wrapper around it

this installer is debian trixie/sid only (won't work on bookworm)

vi

Note. it will look a bit different on current default desktop due to theming difference

https://github.com/thenameisluk/velvet-installer

you can install it via velvet repo (look above on adding velvet repo)

sudo apt install velvet-installer

once installed it should be available in applications menu

Warning. again make sure your device doesn't go into suspense during the installation, this might disrupt the installation

if you encounter any issue with the graphical installer

please report them here

keep in mind this is just a Proof-of-Concept

Note. website generated from markdown using mdplop

in respective repos report issues related to html generations, documantation and images