From NixOS Wiki
m (whitespace cleanup) |
(Adds sub-section about updating it anyway.) |
||
| Line 14: | Line 14: | ||
* <code>stateVersion</code> has nothing to do with the current version of the system<ref>https://logs.nix.samueldr.com/nixos/2018-04-18#1524080358-1524080429;</ref> | * <code>stateVersion</code> has nothing to do with the current version of the system<ref>https://logs.nix.samueldr.com/nixos/2018-04-18#1524080358-1524080429;</ref> | ||
* <em>Do NOT</em> change the <code>stateVersion</code> in the configuration; <nowiki>[it]</nowiki> tells nixos what version your state is; changing it will break the things <nowiki>[it is]</nowiki> meant to fix.<ref>https://logs.nix.samueldr.com/nixos/2017-10-18#1508341107-1508341130;</ref> | * <em>Do NOT</em> change the <code>stateVersion</code> in the configuration; <nowiki>[it]</nowiki> tells nixos what version your state is; changing it will break the things <nowiki>[it is]</nowiki> meant to fix.<ref>https://logs.nix.samueldr.com/nixos/2017-10-18#1508341107-1508341130;</ref> | ||
| + | |||
| + | <strong>When can I update <code>stateVersion</code>?</strong> | ||
| + | |||
| + | When: | ||
| + | # You have read all release notes starting from your <code>stateVersion</code>. | ||
| + | # You have verified all instances of <code>stateVersion</code> in the code in <tt><nowiki><nixpkgs/nixos></nowiki></tt>. | ||
| + | # You have made all manual interventions as required by the changes previously inventoried. | ||
</onlyinclude><noinclude><hr /> | </onlyinclude><noinclude><hr /> | ||
== References == | == References == | ||
</noinclude> | </noinclude> | ||
Revision as of 22:22, 21 April 2018
When do I update stateVersion
Keep stateVersion to the version you originally installed.[1]
The system.stateVersion option is described as such:
Every once in a while, a new NixOS release may change configuration defaults in a way incompatible with stateful data. For instance, if the default version of PostgreSQL changes, the new version will probably be unable to read your existing databases. To prevent such breakage, you can set the value of this option to the NixOS release with which you want to be compatible. The effect is that NixOS will option defaults corresponding to the specified release (such as using an older version of PostgreSQL).
Frequent answers:
stateVersionhas nothing to do with the current version of the system[2]- Do NOT change the
stateVersionin the configuration; [it] tells nixos what version your state is; changing it will break the things [it is] meant to fix.[3]
When can I update stateVersion?
When:
- You have read all release notes starting from your
stateVersion. - You have verified all instances of
stateVersionin the code in <nixpkgs/nixos>. - You have made all manual interventions as required by the changes previously inventoried.