--- name: install-a-package description: Find, check and install a package on Solnix (or another Nix host) from the signed cache. Use when asked to install software. --- # Install a package 1. **Find the attribute.** `search_packages {query}`. Done when you have an attr (`pkgs.solnix.`) for the machine's system: `nix eval --raw --impure --expr builtins.currentSystem` prints it (`x86_64-solaris` or `aarch64-solaris`). 2. **Check it is served.** `package_status {pname, system}`. Done when a served recipe row has `narinfo_served: true`. If not, tell the user it is not installable yet and show `queue`. 3. **Install for the user.** `nix profile install nixpkgs#`. Done when `nix profile list` shows it. **Or for the whole system:** add `pkgs.solnix.` to `environment.systemPackages` and `pfexec solnix-rebuild switch` (a new generation, rollback-able). 4. **Report advisories.** Any `cve_advisories` from step 2, with `fixed_in`. Another Nix host: add the substituter and key from `steering/trust-and-signing.md`, then `nix profile install 'git+https://git.solnix.io/solnix.git#'`. There is no `pkg install` on Solnix (no IPS).