mirror of
https://github.com/nix-community/home-manager
synced 2024-11-14 15:19:45 +01:00
69a96783b1
The `optionsDocBook` function is deprecated in nixpkgs since nixos-23.11. This commit updates the manual and manpages to use commonmark formatted documentation instead of the deprecated docbook format.
47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
# NixOS module {#sec-flakes-nixos-module}
|
|
|
|
To use Home Manager as a NixOS module, a bare-minimum `flake.nix` would
|
|
be as follows:
|
|
|
|
``` nix
|
|
{
|
|
description = "NixOS configuration";
|
|
|
|
inputs = {
|
|
nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
|
|
home-manager.url = "github:nix-community/home-manager";
|
|
home-manager.inputs.nixpkgs.follows = "nixpkgs";
|
|
};
|
|
|
|
outputs = inputs@{ nixpkgs, home-manager, ... }: {
|
|
nixosConfigurations = {
|
|
hostname = nixpkgs.lib.nixosSystem {
|
|
system = "x86_64-linux";
|
|
modules = [
|
|
./configuration.nix
|
|
home-manager.nixosModules.home-manager
|
|
{
|
|
home-manager.useGlobalPkgs = true;
|
|
home-manager.useUserPackages = true;
|
|
home-manager.users.jdoe = import ./home.nix;
|
|
|
|
# Optionally, use home-manager.extraSpecialArgs to pass
|
|
# arguments to home.nix
|
|
}
|
|
];
|
|
};
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
The Home Manager configuration is then part of the NixOS configuration
|
|
and is automatically rebuilt with the system when using the appropriate
|
|
command for the system, such as
|
|
`nixos-rebuild switch --flake <flake-uri>`.
|
|
|
|
You can use the above `flake.nix` as a template in `/etc/nixos` by
|
|
|
|
``` console
|
|
$ nix flake new /etc/nixos -t github:nix-community/home-manager#nixos
|
|
```
|