Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(extra-files) add howto #440

Merged
merged 1 commit into from
Dec 19, 2024
Merged

Conversation

sedlund
Copy link
Contributor

@sedlund sedlund commented Dec 19, 2024

Add a howto for --extra-files

#283

docs/cli.md Outdated
@@ -36,8 +36,8 @@ Options:
* --stop-after-disko
exit after disko formatting, you can then proceed to install manually or some other way
* --extra-files <path>
path to a directory to copy into the root of the new nixos installation.
Copied files will be owned by root.
contents of local <path> are recursively copied and overwrites root (/) of the new NixOS installation.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
contents of local <path> are recursively copied and overwrites root (/) of the new NixOS installation.
contents of local <path> are recursively copied to the root (/) of the new NixOS installation. Existing files are overwritten

When the files are extracted on the remote the copied data will be owned by
root.

### Soft links
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: I think the term "symlinks" / "symbolic links" has won and woudl use that here

$ root=$(mktemp -d)
$ sudo cp --verbose --archive --link --parents /etc/ssh/ssh_host_* ${root}
$ cp --verbose --archive --link /persist ${root} # --parents not needed for a full path
$ lsd --tree --long ${root}
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe remove the lsd call and just post the output as an example layout in another source block? Using non-standard tools in a howto without explaining/installing them could be confusing?

docs/howtos/extra-files.md Outdated Show resolved Hide resolved
@sedlund
Copy link
Contributor Author

sedlund commented Dec 19, 2024

Appreciate the feedback! Let me know if everything is addressed and I will squash.

EDIT: nm there wasnt much to it, so just squashed.

@phaer phaer merged commit bf4c0c5 into nix-community:main Dec 19, 2024
4 checks passed
@phaer
Copy link
Member

phaer commented Dec 19, 2024

Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants