Skip to content

docs: document caisson.useUserPackages and the packages a machine installs - #94

Merged
clhodapp merged 2 commits into
mainfrom
docs/use-user-packages
Nov 11, 2026
Merged

clhodapp merged 2 commits into
mainfrom
docs/use-user-packages

Conversation

@clhodapp

Copy link
Copy Markdown
Contributor

nix-caisson/caisson#149 adds the home-manager option caisson.useUserPackages. A home-manager configuration inside a NixOS machine that sets it leaves its packages to the machine, which installs them in /etc/profiles/per-user/<user> as part of the system.

  • reference/options.md gets an entry for the option, with an example for a user managed by systemd-homed, and a table of what home-manager generations, switch, expire-generations, news and packages show with the option set.
  • reference/lib.md lists submoduleSupport.externalPackageInstall among the options caisson/nixos-parent sets. It also describes how caisson/home-manager-activation installs the packages, for an account in users.users and for a user declared elsewhere.

mdbook build passes.

🤖 Generated with Claude Code

@clhodapp clhodapp self-assigned this Nov 11, 2026
clhodapp and others added 2 commits November 11, 2026 01:33
…talls

The option of nix-caisson/caisson#149 gets an entry in the option
reference, with what home-manager's own commands show when it is set.
The reference of `caisson/nixos-parent` lists the home-manager option
it sets, and the reference of `caisson/home-manager-activation` says how
the machine installs the packages and where it reads the profile.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
… installs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@clhodapp
clhodapp force-pushed the docs/use-user-packages branch from 4ee3e29 to c7d940e Compare November 11, 2026 09:33
@clhodapp
clhodapp merged commit 8eac6fd into main Nov 11, 2026
1 check passed
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.

1 participant