Is there a whitelist of supported services?

[ntninja]

I just tried enabling some settings in services.kubo and it tells me:

       error: The option `services.kubo' does not exist. Definition values:
       - In `/nix/store/5j5ilmvbhxsl1rszd230ig1i8vsxaf2i-source/services/ipfs.nix':
           {
             enable = true;
             enableGC = true;
             localDiscovery = true;
             settings = {
           ...

The older name services.ipfs also doesn’t work, but these settings exist here:
https://search.nixos.org/options?channel=25.11&query=services.kubo

Given that nginx supposidly exists, is there some kind of whitelist of allowed NixOS configuration modules?

[zimbatm]

Did you also import "#{nixpkgs}/nixos/modules/services/network-filesystems/kubo.nix"?

We currently don't actively maintain a list, but it's definitely something we should do.

[ntninja]

You mean adding this to the service configuration:

        imports = [
                "#{nixpkgs}/nixos/modules/services/network-filesystems/kubo.nix"
        ];

It cannot find that… <nixpkgs/nixos/modules/services/network-filesystems/kubo.nix> and nixos/modules/services/network-filesystems/kubo.nix also didn’t work…

Is there documentation for this anywhere?

Thank you!

[zimbatm]

We just revamped our documentation at https://system-manager.net . I think we are still missing a section on how to import custom modules. @jeffcogswell do you mind taking a look?

[ntninja]

Maybe at least a hint on how to do this?

[ntninja]

Actually the answer is:

{ config, nixosModulesPath, pkgs, lib, utils, ... }:

{
   imports = [
      "${nixosModulesPath}/services/network-filesystems/kubo.nix"
   ];

   // …
}

[ntninja]

It does require some stubs, some of these will eventually be implemented by system-manager others not… 🤷🏼‍♀️

{ config, lib, utils, ... }:

{
        options = {
                environment.variables = lib.mkOption {
                        type = lib.types.attrsOf lib.types.any;
                };

                programs.fuse = lib.mkOption {
                        type = lib.types.attrsOf lib.types.any;
                };

                system.stateVersion = lib.mkOption {
                        type = lib.types.str;
                };
        };

        config = {
                system.stateVersion = "25.11";
        };
}

[jfroche]

Since your initial message, we improved the documentation and I think the answer is in that document: https://system-manager.net/main/how-to/import-nixos-module/
Tell us if we are missing something in that document that would helped you.

We can't have a white list of supported modules yet as it requires a lot of resources.

[ntninja]

That was a relatively recent addition then, as mentioned above I got it to work along those lines.

The docs are good, just one aesthetic nit:

It’s nicer to write it using variable substitution:

{ nixosModulesPath, ... }:
{
  imports = [
    "${nixosModulesPath}/services/monitoring/prometheus/exporters.nix"
  ];
}

… then braced concatenation:

{ nixosModulesPath, ... }:
{
  imports = [
    (nixosModulesPath + "/services/monitoring/prometheus/exporters.nix")
  ];
}