particle-os/bootc-docs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
5 commits 1 branch 0 tags 424 KiB
Commit graph

5 commits

This branch
This branch
All branches
Author SHA1 Message Date
robojerk
49281ba325 Update Debian version recommendations based on current release status 
DEBIAN VERSION UPDATES:
- Debian 12 (Bookworm) is now oldstable with outdated OSTree packages
- Debian 13 (Trixie) is now stable and recommended for bootc
- Debian 14 (Forky) is testing with latest OSTree libraries
- Update all Containerfiles to use debian:trixie-slim

OSTREE COMPATIBILITY:
- Document OSTree version requirements for each Debian release
- Add backporting guide for newer OSTree libraries from Forky to Trixie
- Explain benefits of newer OSTree (bootupd support, better bootc compatibility)
- Update compatibility matrix with current Debian status

RECOMMENDATIONS:
- Recommend Debian 13 (Trixie) as minimum for production use
- Suggest Debian 14 (Forky) for latest OSTree libraries
- Provide backporting instructions for Trixie users
- Update testing matrix to reflect current Debian releases

This addresses the critical issue that Debian 12's OSTree packages
are too old for modern bootc/bootupd requirements.
 2025-09-15 14:21:53 -07:00
robojerk
d2238df478 Critical safety and compatibility fixes based on ChatGPT feedback 
SAFETY FIXES:
- Add prominent safety warnings for destructive operations
- Add BOOTC_I_KNOW_THIS_WIPES_MY_DISK environment variable checks
- Add safety warnings to manual installation scripts

BUILD FIXES:
- Fix Containerfile systemd calls to use symlinks instead of systemctl
- Replace brittle image validation with podman image mount
- Add fallback for rootless/mount issues

COMPATIBILITY FIXES:
- Align Debian version references (12 Bookworm vs 14 Forky)
- Add comprehensive COMPATIBILITY.md with version matrix
- Add kernel requirements for composefs (5.15+ basic, 6.5+ recommended)
- Document experimental flags and version requirements

TECHNICAL IMPROVEMENTS:
- Use DEBIAN_FRONTEND=noninteractive in build scripts
- Improve image inspection robustness
- Add explicit version testing matrix
- Document known issues and workarounds

This addresses the most critical issues identified in the ChatGPT review:
1. Safety warnings for destructive operations
2. Build-time systemd handling fixes
3. Robust image validation methods
4. Version compatibility documentation
 2025-09-15 14:19:12 -07:00
robojerk
4f6cc99ba2 Remove bootc submodule and ignore bootc directory 
- Remove bootc git submodule (user doesn't want it)
- Update .gitignore to ignore bootc/ directory
- Remove .gitmodules file
- Documentation is self-contained without source code dependency
 2025-09-15 14:05:16 -07:00
robojerk
cea1a07a43 Update .gitignore: Remove bootc/ ignore since it's a submodule 
- Remove ./bootc/ from .gitignore since bootc is now a git submodule
- Add standard ignore patterns for temporary files, editor files, OS files
- Add note explaining that bootc/ is a submodule, not ignored
 2025-09-15 14:04:06 -07:00
robojerk
526f1c1afd Initial commit: Comprehensive Debian bootc documentation 
- Complete documentation for all bootc commands and subcommands
- Debian-specific adaptations and workarounds
- Manual installation methods to bypass bootc reliability issues
- Technical guides with Rust source code analysis
- Flowcharts and external command references
- Hidden command documentation (bootc internals, state, etc.)
- Composefs integration analysis
- Base image creation guides (with and without bootc binary)
- Management scripts and automation
- Comprehensive troubleshooting and examples
 2025-09-15 14:02:28 -07:00