History

robojerk eca28aae28 first commit		2025-08-05 04:14:29 +00:00
..
calamares	first commit	2025-08-05 04:14:29 +00:00
config	first commit	2025-08-05 04:14:29 +00:00
live-build	first commit	2025-08-05 04:14:29 +00:00
scripts	first commit	2025-08-05 04:14:29 +00:00
justfile	first commit	2025-08-05 04:14:29 +00:00
lb_resources.md	first commit	2025-08-05 04:14:29 +00:00
README.md	first commit	2025-08-05 04:14:29 +00:00

README.md

Debian Atomic Desktop - Phase 2: Calamares Installer

This is Phase 2 of the Debian Atomic Desktop project, focusing on creating a bootable ISO with a Calamares installer that can deploy the atomic image.

Project Overview

Phase 2 builds upon the Phase 1 foundation to create a complete installation experience. The goal is to create a bootable ISO that presents a Calamares installer, which successfully installs the minimal atomic image created in Phase 1.

Note: This build system is designed to create Debian Trixie ISOs from Ubuntu Noble hosts.

Prerequisites

Ubuntu Noble host system
live-build for creating the live ISO environment
calamares package and dependencies
qemu-system-x86_64 for testing the ISO
Access to the Phase 1 image (either embedded or from a registry)
Internet connection for downloading Debian Trixie packages

Quick Start

Build the installer ISO:
```
just build-iso
```
Test the ISO in QEMU:
```
just test-iso
```
Clean up build artifacts:
```
just clean-iso
```

Available Commands

Use just --list to see all available commands.

Build Commands

just build-iso - Build the bootable ISO with Calamares installer
just build-iso-debug - Build with debug output

Testing Commands

just test-iso - Test the ISO in QEMU
just test-iso-gui - Test with GUI (if available)

Maintenance Commands

just clean-iso - Clean up ISO build artifacts
just clean-all - Clean all build artifacts

ISO Contents

The Phase 2 ISO includes:

Minimal Debian live environment
Calamares installer with custom configuration
Integration with the Phase 1 atomic image
Automated partitioning and installation

Configuration

The installer uses custom Calamares configuration files:

calamares/settings.conf - Main settings
calamares/modules/ - Module configurations
calamares/branding/ - Custom branding

Installation Process

Boot from the ISO
Calamares installer launches automatically
User configures language, location, and user account
Installer partitions the disk and installs the atomic image
System reboots into the installed atomic desktop

Next Steps

This is Phase 2 of the roadmap. Future phases will include:

Phase 3: Desktop environment and kernel modules
Phase 4: Polish and distribution

Development

The project uses:

live-build/ - Live ISO build configuration
calamares/ - Calamares installer configuration
justfile - Build automation
scripts/ - Helper scripts for the build process