Repository navigation
docs: Emergency recovery guide for sliceanddice boot issues - #188
Merged
Merged
Conversation
Add comprehensive recovery documentation and diagnostic script for emergency mode issues. Includes analysis of master vs development branch differences and step-by-step recovery procedures. Addresses potential causes: - Missing disko.nix import from development branch - Filesystem mounting failures - Boot partition space issues - Configuration branch mismatches Co-authored-by: Alex Spaulding <[email protected]>
Co-authored-by: Alex Spaulding <[email protected]>
Provides one-command fix for emergency mode issues. The script: - Detects configuration problems (missing disko.nix, wrong branch) - Switches to stable master branch - Rebuilds the system configuration - Provides clear feedback and next steps Usage: sudo bash fix-emergency-auto.sh Co-authored-by: Alex Spaulding <[email protected]>
Central emergency recovery documentation that ties all the recovery resources together. Provides quick navigation to the right solution based on user's situation and technical comfort level. Co-authored-by: Alex Spaulding <[email protected]>
Co-authored-by: Alex Spaulding <[email protected]>
Co-authored-by: Alex Spaulding <[email protected]>
Add comprehensive debugging and fix guides for: - TTY1 blank cursor / gtkgreet not starting - Cursor running multiple instances - Wayland/XWayland display issues Includes diagnostic scripts and step-by-step troubleshooting. Co-authored-by: Alex Spaulding <[email protected]>
Combines emergency mode, TTY1 greeter, and Cursor multi-instance issues into one reference document with quick fixes and documentation index. Co-authored-by: Alex Spaulding <[email protected]>
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
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.
Problem
The sliceanddice system entered emergency mode after recent changes. Analysis reveals a branch mismatch issue between
masteranddevelopment.Root Cause
The
developmentbranch includes new sliceanddice configuration that imports additional files:disko.nix- disk/filesystem configuration (btrfs layout)kbd-bl-ask.nix- keyboard backlight configurationmsi-ec-sword-kbd-disable.patch- MSI EC kernel patchIf the system tried to rebuild with development branch config but these files were missing or inaccessible, it would fail to activate and drop into emergency mode.
Solution Provided
This PR adds comprehensive recovery documentation:
📋 Files Added
🚀 Quick Recovery Steps
For the user:
cd /etc/nixos/.dotfiles && git checkout mastersudo nixos-rebuild switch --flake .#sliceanddice📊 Branch Comparison
Master (current, stable):
Development (ahead, new features):
Files Changed
Testing
The recovery procedures are based on:
Recommendations
Related Commits
ba8fb7cb- feat(sliceanddice): on-disk NixOS installer + btrfs disko (development)963b83f1- fix(sliceanddice): cap systemd-boot generations (development)6142c7b2- feat(sliceanddice): silent Windows IoT LTSC dual-boot (development)These commits on the development branch added features that require the additional files.