particle-os/bootc-docs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

CRITICAL: Correct dangerous claims about bootc production readiness

Browse source 
EXPERIMENTAL WARNINGS:
- Add prominent warnings that bootc on Debian is HIGHLY EXPERIMENTAL
- Clarify that NO reproducible bootc images exist yet
- Warn that everything is still experimental and not production-ready
- Add DO NOT use in production warnings throughout

DEBIAN VERSION CORRECTIONS:
- Use Debian Sid (unstable) for base image building (like Fedora rawhide)
- Correct dangerous claims about 'tested' configurations
- Mark all configurations as experimental, not tested
- Remove false claims about production readiness

SAFETY IMPROVEMENTS:
- Add experimental warnings to all base image documentation
- Clarify that bootc is not stable on Debian yet
- Emphasize testing-only use on virtual machines
- Remove misleading production recommendations

This corrects dangerous misinformation that could lead to
data loss and system instability in production environments.
This commit is contained in:
robojerk 2025-09-15 14:24:27 -07:00
parent 49281ba325
commit 72155be8de
4 changed files with 40 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

25
COMPATIBILITY.md
View file

@ -97,12 +97,13 @@ sudo apt install -y ostree podman systemd
## Testing Matrix
### Tested Configurations
- ✅ Debian 13 (Trixie) + bootc v1.1.4 + Podman 4.0 (recommended)
- ✅ Debian 14 (Forky) + bootc v1.1.4 + Podman 4.0 (ideal)
- ⚠️ Debian 12 (Bookworm) + manual installation + bootc management (old OSTree)
### Experimental Configurations
- ⚠️ Debian 13 (Trixie) + bootc v1.1.4 + Podman 4.0 (experimental, not fully tested)
- ⚠️ Debian 14 (Forky) + bootc v1.1.4 + Podman 4.0 (experimental, not fully tested)
- ⚠️ Debian 12 (Bookworm) + manual installation + bootc management (old OSTree, experimental)
- ⚠️ Debian 12 (Bookworm) + composefs backend (experimental, old OSTree)
- ❌ Debian 11 (Bullseye) - Not tested, may have issues
- ❌ **No reproducible bootc images exist yet** - All configurations are experimental
### Untested Configurations
- Other Debian derivatives (Ubuntu, etc.)
@ -137,13 +138,15 @@ sudo apt update
## Recommendations
### For Production Use
1. **Use Debian 13 (Trixie)** as the minimum recommended version
2. **Consider Debian 14 (Forky)** for latest OSTree libraries
3. **Backport OSTree** from Forky to Trixie if needed
4. **Use manual installation** methods provided in this documentation
5. **Test thoroughly** on virtual machines before production deployment
6. **Keep backups** of critical data and configurations
7. **Monitor bootc releases** for Debian compatibility improvements
⚠️ **WARNING: bootc on Debian is EXPERIMENTAL and NOT production-ready**
1. **DO NOT use in production** - All configurations are experimental
2. **No reproducible bootc images exist** - Everything is still experimental
3. **Use only for testing** on virtual machines or test hardware
4. **Keep backups** of critical data and configurations
5. **Expect failures** - bootc is not stable on Debian yet
6. **Monitor bootc releases** for Debian compatibility improvements
7. **Contribute fixes** back to the bootc project
### For Development
1. **Use the hybrid approach**: Manual install + bootc management