@puu/install
v1.2.0
Published
Puu OS install
Readme
puu-install
puu-install is a standalone installer for bootc based operating systems.
Deployment configuration
A deployment configuration must be provided either via --config-path or
PUU_INSTALL_CONFIG.
This is the default configuration:
branding:
name: Linux
partitions:
efi: 512M
rootMin: 64G
home: 256G
labels:
root: root
swap: swap
home: home
image:
targetImgRef: "" # required unless provided by image.manifest
expectedDigest: "" # sha256 of raw OCI manifest for local sources
sourceLabel: PAYLOAD
sourceMount: /run/puu-install/payload
identity:
keymap: us
locale: C.UTF-8
timezone: UTC
hostname: localhost
homed:
groups: []
identityPath: /var/lib/firstboot/homed-identity.json
sessionLauncher: "" # omitted from user record when empty
seeds: [] # list of {name, target, liveStore, syncHelper, manifestPath}
k3s: null # optional {role, serverUrl, nodeName}
kernelArgs: []
serialConsole: {} # map of machine name -> consoleOptional K3s token must be passed via --k3s-token-file.
Development
For native development on Linux:
- Install the build dependencies listed in
Dockerfile. - Install
abseil-cppfor foundational C++ utilities:- Debian/Ubuntu:
libabsl-dev. - Fedora:
abseil-cpp-devel.
- Debian/Ubuntu:
- Follow Google C++ Style Guide.
- Vendor dependencies other than Abseil and the existing platform libraries with FetchContent, pinned to hash-checked upstream release tarballs.
Licensing
puu-install has been licensed with the GNU General Public License 2.0, or a
newer version. Study LICENSE for further details.
