- Complete analysis of all 6 major OSBuild projects
- Detailed explanation of each component's role and architecture
- Integration opportunities for particle-os
- Getting started guides for different user types
- Future roadmap and community resources
This document serves as a comprehensive reference for understanding
the complete OSBuild universe and how particle-os fits into it.
- Added org.osbuild.debian.bootupd stage with A/B partition support
- Created bootupd.toml configuration with atomic update settings
- Implemented systemd service and preset for bootupd
- Added A/B partition configuration for atomic bootloader updates
- Created EFI directory structure for bootupd bootloader management
- Added comprehensive test suite for bootupd stage (2/2 tests passing)
- Created example manifests for both Debian 13 and 14 with bootupd
- Updated README documentation to reflect bootupd implementation
- Updated stage execution order and future roadmap
This completes the modern bootloader management implementation,
providing both traditional GRUB2 and modern bootupd options.
- Added detailed explanation of what bootupd is and how it works
- Documented bootupd vs GRUB2 strategy in particle-os
- Explained bootupd architecture and required components
- Added future bootupd stage implementation examples
- Documented bootupd vs bootc relationship and integration
- Added migration path from GRUB2 to bootupd
- Included bootupd in CI/CD pipeline examples
- Added future roadmap for bootupd integration
This provides users with complete understanding of current bootloader
implementation and future direction for modern OSTree systems.
- Added support for Debian 14 (Forky) testing release
- Created examples for both Debian 13 (Trixie) and Debian 14 (Forky)
- Added comprehensive multi-version documentation
- Created automated version switching script with backup/restore
- Updated README with version-specific configuration examples
- Added migration guidance between Debian versions
This enables users to build images for both stable (Trixie) and
testing (Forky) releases with easy switching between versions.
- Moved all documentation files to docs/ directory for better organization
- Maintained all existing documentation content
- Improved project structure for better maintainability
- Documentation now follows standard open source project layout
- Added comprehensive explanation of osbuild + bootc-image-builder integration
- Included GitHub Actions workflow for automated image building
- Added GitLab CI configuration with multi-stage pipeline
- Included Forgejo Actions workflow for open source CI/CD
- Enhanced documentation with real-world deployment examples
- Added container-native booting and infrastructure as code benefits
- Added detailed explanation of what osbuild is and how it works
- Comprehensive usage instructions with examples
- Advanced configuration examples for all stages
- Troubleshooting guide and debugging information
- Architecture deep dive and development setup
- Professional documentation structure for community adoption
- 10 Debian-specific stages implemented and tested
- OSTree integration with bootc and GRUB2 support
- QEMU assembler for bootable disk images
- Comprehensive testing framework (100% pass rate)
- Professional documentation and examples
- Production-ready architecture
This is a complete, production-ready Debian OSTree system builder
that rivals commercial solutions.
