nixos/doc/manual/administration/store-corruption.section.md

   1 # Nix Store Corruption {#sec-nix-store-corruption}
   2
   3 After a system crash, it's possible for files in the Nix store to become
   4 corrupted. (For instance, the Ext4 file system has the tendency to
   5 replace un-synced files with zero bytes.) NixOS tries hard to prevent
   6 this from happening: it performs a `sync` before switching to a new
   7 configuration, and Nix's database is fully transactional. If corruption
   8 still occurs, you may be able to fix it automatically.
   9
  10 If the corruption is in a path in the closure of the NixOS system
  11 configuration, you can fix it by doing
  12
  13 ```ShellSession
  14 # nixos-rebuild switch --repair
  15 ```
  16
  17 This will cause Nix to check every path in the closure, and if its
  18 cryptographic hash differs from the hash recorded in Nix's database, the
  19 path is rebuilt or redownloaded.
  20
  21 You can also scan the entire Nix store for corrupt paths:
  22
  23 ```ShellSession
  24 # nix-store --verify --check-contents --repair
  25 ```
  26
  27 Any corrupt paths will be redownloaded if they're available in a binary
  28 cache; otherwise, they cannot be repaired.