docs: added a note on conflicts to the standalone installation section #8238
+22
−0
Conversation
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
The documentation on the standalone installation didn't detail how to automatically resolve installation conflicts even though that is a feature of the bash script. Added it as an aside and verified with `nix-run -A docs.html` to make sure all formatting looked good. Signed-off-by: Ben Raz <[email protected]>
teto
reviewed
Nov 30, 2025
| $ HOME_MANAGER_BACKUP_OVERWRITE=1 nix-shell '<home-manager>' -A install | ||
| ``` | ||
| ::: | ||
|
|
Collaborator
There was a problem hiding this comment.
I am not familiar with this usage of hm but:
- I dont like the use of environment variables. It goes opposite of the nix way that is explicit about everything.
-b bakshould be equivalent. - the installation process is always a painful one so we should strive to keep it simple and not dive into too many details.
HOME_MANAGER_BACKUP_OVERWRITEcan be omitted, the previous section should be enough to unblock the user. It could be mentioned as a link towards a more relevant documentation eg "See more". I dont think HOME_MANAGER_BACKUP_OVERWRITE is documented though.-Bcan probably be leveraged to the same effect.
Collaborator
|
while doing some triage: #3524 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Description
When running the installer through
nix-shell "<home-manager>" -A install, any conflicts will lead to the installation aborting. This can be a problem if you installed the~/.config/home-manager/home.nixbefore home-manager itself. There is very little documentation on how to fix this in the manual, so after figuring out how to do it, I decided to extend the documentation on the standalone installation with this information.Potential issues
Checklist
Change is backwards compatible.
Code formatted with
nix fmtornix-shell -p treefmt nixfmt deadnix keep-sorted --run treefmt.Code tested through
nix run .#tests -- test-allornix-shell --pure tests -A run.all.Test cases updated/added. See example.
Commit messages are formatted like
See CONTRIBUTING for more information and recent commit messages for examples.
If this PR adds a new module
If this PR adds an exciting new feature or contains a breaking change.