Add README and LICENSE files

This commit is contained in:
2025-09-23 01:21:04 -04:00
parent 809418ff98
commit 998f8ed1a9
2 changed files with 719 additions and 0 deletions

45
README.md Normal file
View File

@@ -0,0 +1,45 @@
# livebuilds
livebuilds is a simple Makefile using GNU Stow packages to manage configuration
for building custom Debian live ISO images in a minimal and reproducible
workflow.
## Quick Start
The Makefile automates initialization, configuration, build, and optional test
run of the generated image. Typical usage:
1. Build the image
make
Initializes the build directory, configures it using `stow` packages, and
runs `live-build` to produce the ISO in `./builds/$DIST/`.
2. Boot the image in a VM (QEMU/KVM via libvirt)
make install
Launches a `virt-install` user session, attaching the newly created ISO.
3. Clean up everything
make clean
Destroys and undefines the VM (`live_trixie` by default) and removes the
entire `./builds` directory.
## Copyright and License
Copyright (C) 2025 Kris Lamoureux
This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, version 3 of the License.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program. If not, see <https://www.gnu.org/licenses/>.