Debian Atomic Desktop Project

A project to create a Debian-based atomic desktop system using bootc and OSTree, inspired by ublue-os.

Project Structure

This project is organized into phases:

Phase 1: 01-debian-atomic/

• Goal: Create a minimal, bootable Debian Trixie atomic image
• Status: ✅ Complete
• Contents:
  • Containerfile - Defines the base atomic image
  • justfile - Build automation
  • README.md - Phase 1 documentation

Phase 2: 02-installer/

• Goal: Create a bootable ISO with Calamares installer
• Status: 🔄 In Progress (Contents file issues being resolved)
• Contents:
  • justfile - Live-build automation
  • calamares/ - Installer configuration
  • config/ - Live-build configuration
  • scripts/ - Helper scripts

Phase 2 Alternative: 02-installer-bootc/

• Goal: Alternative approach using container-based VM testing
• Status: 🔄 In Progress
• Contents:
  • Containerfile - VM container definition
  • justfile - Container build automation
  • scripts/ - Testing scripts

Quick Start

1. Phase 1 (Atomic Image):

   cd 01-debian-atomic
   just build-image
   just test-image
   

2. Phase 2 (Installer ISO):

   cd 02-installer
   just build-iso
   

3. Phase 2 Alternative (Container VM):

   cd 02-installer-bootc
   just build-container
   just test-container
   

Prerequisites

• just command runner
• podman or docker
• live-build (for Phase 2)
• qemu-system-x86_64 (for testing)

Development

See roadmap.md for detailed project planning and todo for current tasks.

License

This project is open source. See individual files for specific licensing information.