88 lines
No EOL
2.5 KiB
Markdown
88 lines
No EOL
2.5 KiB
Markdown
# 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
|
|
|
|
1. **Build the installer ISO:**
|
|
```bash
|
|
just build-iso
|
|
```
|
|
|
|
2. **Test the ISO in QEMU:**
|
|
```bash
|
|
just test-iso
|
|
```
|
|
|
|
3. **Clean up build artifacts:**
|
|
```bash
|
|
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
|
|
|
|
1. Boot from the ISO
|
|
2. Calamares installer launches automatically
|
|
3. User configures language, location, and user account
|
|
4. Installer partitions the disk and installs the atomic image
|
|
5. 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 |