Skip to content

Recommend nix-shell instead of nix-env for NixOS installation #14045

Description

@babakks

Description

Our NixOS instructions currently recommend nix-env, which the NixOS package website discourages:

Warning: Using nix-env permanently modifies a local profile of installed packages. This must be updated and maintained by the user in the same way as with a traditional package manager, foregoing many of the benefits that make Nix uniquely powerful. Using nix-shell or a NixOS configuration is recommended instead.

Fix

We should recommend nix-shell -p gh for temporary use, then direct users to the NixOS package installation instructions for permanent installation.

Activity

  1. github-actions commented on Aug 3, 2026

    @github-actions
    Contributor

    Thank you for your issue! We have categorized it as an enhancement (feature or improvement) request, and it has been added to our backlog. In doing so, we are not committing to implementing this feature at this time, but, we will consider it for future releases based on community feedback and our own product roadmap.

    Unless you see the help wanted Contributions welcome label, we are not currently looking for external contributions for this feature.

    If you come across this issue and would like to see it implemented, please add a thumbs up! This will help us prioritize the feature. Please only comment if you have additional information or viewpoints to contribute.

  2. cli-triage commented on Aug 3, 2026

    @cli-triage

    This is a clear documentation improvement request: updating the NixOS installation instructions to recommend nix-shell (or the NixOS package page) over nix-env, which NixOS itself discourages. The rationale is well-explained and the proposed fix is specific.

    No duplicates found — the related issue #8353 (closed) was about initially adding Nix installation instructions, which was completed; this issue is a follow-up improvement.

    The existing enhancement label is appropriate. No additional labels are suggested at this time — the issue is ready for engineering/docs review as-is.

    Generated by Issue Triage (skills-driven) for #14045 · sonnet46 · 20.4 AIC · ⌖ 5 AIC · ⊞ 6.6K · ◷

  3. babakks commented on Aug 3, 2026

    @babakks
    MemberAuthor

    There's already a PR for this that we may want to reopen if the OP (@NyCodeGHG) updates it.

  4. added 2 commits that reference this issue on Aug 3, 2026
    cbf1d4c
    e0081cd
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions