mirror of
https://github.com/nix-community/home-manager
synced 2024-12-25 19:29:47 +01:00
35536fc6d6
The beets package no longer has the "enableCheck" option so this was confusing. Also the word override was used to mean two different things so I modified the FAQ to use the word "change" and linked to documentation regarding package overrides.
66 lines
1.6 KiB
Markdown
66 lines
1.6 KiB
Markdown
# How do I change the package used by a module? {#_how_do_i_change_the_package_used_by_a_module}
|
|
|
|
By default Home Manager will install the package provided by your chosen
|
|
`nixpkgs` channel but occasionally you might end up needing to change
|
|
this package. This can typically be done in two ways.
|
|
|
|
1. If the module provides a `package` option, such as
|
|
`programs.beets.package`, then this is the recommended way to
|
|
perform the change. For example,
|
|
|
|
``` nix
|
|
programs.beets.package = pkgs.beets.override { pluginOverrides = { beatport.enable = false; }; };
|
|
```
|
|
|
|
See [Nix pill 17](https://nixos.org/guides/nix-pills/nixpkgs-overriding-packages.html)
|
|
for more information on package overrides. Alternatively, if you want
|
|
to use the `beets` package from Nixpkgs unstable, then a configuration like
|
|
|
|
``` nix
|
|
{ pkgs, config, ... }:
|
|
|
|
let
|
|
|
|
pkgsUnstable = import <nixpkgs-unstable> {};
|
|
|
|
in
|
|
|
|
{
|
|
programs.beets.package = pkgsUnstable.beets;
|
|
|
|
# …
|
|
}
|
|
```
|
|
|
|
should work OK.
|
|
|
|
3. If no `package` option is available then you can typically change
|
|
the relevant package using an
|
|
[overlay](https://nixos.org/nixpkgs/manual/#chap-overlays).
|
|
|
|
For example, if you want to use the `programs.skim` module but use
|
|
the `skim` package from Nixpkgs unstable, then a configuration like
|
|
|
|
``` nix
|
|
{ pkgs, config, ... }:
|
|
|
|
let
|
|
|
|
pkgsUnstable = import <nixpkgs-unstable> {};
|
|
|
|
in
|
|
|
|
{
|
|
programs.skim.enable = true;
|
|
|
|
nixpkgs.overlays = [
|
|
(self: super: {
|
|
skim = pkgsUnstable.skim;
|
|
})
|
|
];
|
|
|
|
# …
|
|
}
|
|
```
|
|
|
|
should work OK.
|