History

robojerk 4a70ed728c Document all working commands and validation methods - Created WORKING_COMMANDS.md with comprehensive command documentation - Added validate-image command to justfile (bootc container lint) - Added check-image-labels command to justfile (OSTree validation) - Added test-via-loopback command to justfile (working deployment method) - Updated help documentation with new commands - Documented critical environment variables and requirements - Recorded all tested and validated commands for future reference All commands have been tested and validated throughout the project.		2025-08-07 09:24:40 -07:00
..
Containerfile	Complete Phase 1: Resolve kernel detection and bootc lint issues	2025-08-07 09:15:54 -07:00
justfile	Document all working commands and validation methods	2025-08-07 09:24:40 -07:00
README.md	first commit	2025-08-05 04:14:29 +00:00

README.md

Debian Atomic Desktop - Phase 1

This is Phase 1 of the Debian Atomic Desktop project, focusing on creating a minimal, bootable Debian OSTree image with automated build processes.

Project Overview

This project aims to create a Debian-based atomic desktop distribution using bootc, similar to ublue-os but leveraging the Debian ecosystem. Phase 1 focuses on establishing the foundational build system and creating a minimal bootable image.

Prerequisites

podman or docker for container builds
just for build automation
bootc for OSTree image management (for testing)

Quick Start

Build the image:
```
just build-image
```
Test the image:
```
just test-image
```
Test with systemd (for bootc compatibility):
```
just test-image-systemd
```

Available Commands

Use just --list to see all available commands, or run just help for a summary.

Build Commands

just build-image - Build the container image with latest tag
just build-image-tag <tag> - Build with a specific tag

Testing Commands

just test-image - Run the image interactively
just test-image-systemd - Run with systemd support (privileged mode)

Maintenance Commands

just clean - Remove the latest image
just clean-all - Remove all debian-atomic images
just list-images - List all debian-atomic images
just inspect-image - Show detailed image information

Image Contents

The Phase 1 image includes:

Debian Trixie base
Essential system packages (systemd, dbus, sudo, etc.)
Network management (NetworkManager)
SSH server
Basic utilities (curl, wget, vim, htop)
Default user account (user/password)

Next Steps

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

Phase 2: Calamares installer integration
Phase 3: Desktop environment and kernel modules
Phase 4: Polish and distribution

Development

The project uses:

Containerfile - Defines the container image
justfile - Build automation and testing
roadmap.md - Project roadmap and phases

Contributing

This is currently in Phase 1 development. The focus is on establishing a solid foundation before adding more complex features.