[Backport release-0.9] docs: improve standalone bootc installation documentation#861
Merged
Merged
Conversation
## Summary
Restructured the standalone installation guide to better serve both end
users and developers by separating concerns and fixing several issues.
### User-focused improvements
- ✅ Simplified installation section with two clear methods:
1. Kickstart ISO creation (for fresh installs)
2. `system-reinstall-bootc` (for existing systems)
- ✅ Fixed curl commands to properly download and save files with `-o`
flags
- ✅ Fixed typo: `system-reintall-bootc` → `system-reinstall-bootc`
- ✅ Fixed URL example formatting (removed extra backtick)
- ✅ Improved clarity: "you will get a banner" → "the system displays a
banner"
- ✅ Added consistent terminology using `{term}\`operator\``
### Developer-focused additions
- ✅ New comprehensive **Development** section covering:
- Building bootc images (single and multi-arch)
- Testing in containers with `make bootc-run`
- Creating bootable QCOW2 and ISO images
- Kickstart ISO generation with ARM64 support
- Fast iteration workflow with `make bootc-reload-app`
- Troubleshooting common LVM, MicroShift, and config service issues
- Cleanup procedures
- Image customization
- Registry publishing (single and multi-arch)
## Before/After
**Before:** Mixed user and developer content, broken commands, unclear
workflow
**After:** Clear separation - users get simple installation methods,
developers get complete build/test/publish workflow
## Test plan
- [x] Verified curl commands download files correctly
- [x] Verified all Makefile targets referenced exist in the actual
Makefile
- [x] Checked markdown syntax and RST directives render correctly
- [x] Confirmed command examples are copy-pastable
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
(cherry picked from commit 1fd6d74)
4 tasks
mangelajo
approved these changes
Jul 7, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Bot-based backport to
release-0.9, triggered by a label in #841.