KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #typescript #codex #cli #claude-code #mcp #rust #deepseek-harness #ai-agent

nixos-facter-modules

★ 179 Open GitHub ↗

A series of NixOS modules to be used in conjunction with https://github.com/nix-community/nixos-facter [maintainer=@brianmcgee,@Mic92]

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# nixos-facter-modules

> [!WARNING]
> **This repository is deprecated.** The modules have been upstreamed to nixpkgs.
> Please use the nixpkgs version instead:
>
> ```nix
> {
>   hardware.facter.reportPath = ./facter.json;
> }
> ```
>
> See the [nixpkgs documentation](https://search.nixos.org/options?query=facter) for more details.

---

A series of [NixOS modules] to be used in conjunction with [NixOS Facter].

With a similar goal to [NixOS Hardware], these modules are designed around _fine-grained_ feature detection as opposed to system models.
This is made possible by the hardware report provided by [NixOS Facter].

By default, these modules enable or disable themselves based on detected hardware.

For more information, see the [docs].

[NixOS modules]: https://wiki.nixos.org/wiki/NixOS_modules
[NixOS Facter]: https://github.com/nix-community/nixos-facter
[NixOS Hardware]: https://github.com/NixOS/nixos-hardware
[docs]: https://nix-community.github.io/nixos-facter-modules/

## Getting started

To generate a hardware report run the following:

```console
$ nix --extra-experimental-features "flakes nix-command" run github:nix-community/nixos-facter > facter.json
```

Then use the generated `facter.json` with the NixOS module as follows:

## NixOS with flakes

We are currently assuming that a the system uses [disko](https://github.com/nix-community/disko),
so we have not implemented `fileSystems` configuration. If you don't use disko, you have to currently specify
that part of the configuration yourself or take it from `nixos-generate-config`.

```nix
# flake.nix
{
  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
  };

outputs =
    inputs@{ nixpkgs, ... }:
    {
      nixosConfigurations.basic = nixpkgs.lib.nixosSystem {

modules = [
          { config.hardware.facter.reportPath = ./facter.json; }
          # If you want to test out nixos-facter, you can add these dummy
          # values to make the configuration valid. Note that this likely won't boot if
          # it doesn't match your own partitioning
          # {
          #   users.users.root.initialPassword = "fnord23";
          #   boot.loader.grub.devices = lib.mkForce [ "/dev/sda" ];
          #   fileSystems."/".device = lib.mkDefault "/dev/sda";
          # }
          # ...
          ## You also need to define your bootloader if you are not using grub
          #{ boot.loader.systemd-boot.enable = true; }
        ];
      };
    };
}
```

## Non-flakes NixOS

```nix
# configuration.nix
{
  config.hardware.facter.reportPath = ./facter.json;
}
```

nixos-facter-modules

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README