jeirmeister/nixos-config-master
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
nixos-config-master/documentation/recovery
History
jeirmeister 983a08600d fix(system): recover from failed boot due to filesystem issues 
Recovery process required multiple steps:
- Disabled failed swap mount from SteamOS partition in hardware-configuration.nix
- Established network connectivity in emergency mode for Jovian packages
- Separated boot loader config from configuration.nix into hardware-configuration.nix
- Remounted root and /nix/store with write permissions
- Rebuilt system with working network connection

Added documentation and recovery tools:
- Network recovery procedures and scripts
- Filesystem troubleshooting guides
- Common issues and solutions for Steam Deck NixOS
- Prevention strategies for future issues

The system now boots successfully into GUI environment. Documentation and
scripts are available under documentation/ to assist with similar recovery
scenarios in the future.
2024-10-30 16:53:48 -07:00
..
README.md fix(system): recover from failed boot due to filesystem issues 2024-10-30 16:53:48 -07:00

README.md

NixOS Steam Deck Recovery Procedures

This documentation covers recovery procedures for NixOS on Steam Deck. It was created based on real recovery scenarios and provides practical solutions for common issues.

Quick Reference

  1. Boot Issues

  2. Network Issues

  3. Filesystem Issues

Emergency Recovery Steps

  1. Boot into emergency mode
  2. Establish network connectivity
  3. Fix configuration issues
  4. Rebuild system
  5. Verify and reboot

Prevention Strategies

  1. Maintain separate configurations:

    • Main configuration
    • Minimal fallback configuration
    • Hardware-specific configuration

  2. Regular backups of working configurations

  3. Testing changes in VM before applying

  4. Maintaining recovery tools and scripts