Meta Options

The following is a list of options that can be added to the meta attribute set.

For compatibility with NixOps, you may name it network instead of meta. However, you cannot specify both at the same time.

description

A short description for the configuration.

Type: string

Default

"A Colmena Hive"

machinesFile

Use the machines listed in this file when building this hive configuration.

If your Colmena host has nix configured to allow for remote builds (for nix-daemon, your user being included in trusted-users) you can set a machines file that will be passed to the underlying nix-store command during derivation realization as a builders option. For example, if you support multiple orginizations each with their own build machine(s) you can ensure that builds only take place on your local machine and/or the machines specified in this file.

See https://nixos.org/manual/nix/stable/#chap-distributed-builds for the machine specification format.

Type: null or path

Default

null

name

Name of the configuration.

Type: string

Default

"hive"

nixpkgs

Pinned Nixpkgs. Accepts one of the following:

  • A path to a Nixpkgs checkout
  • The Nixpkgs lambda (e.g., import )
  • An initialized Nixpkgs attribute set

This option must be specified when using Flakes.

Type: unspecified

Default

null

nodeNixpkgs

Node-specific Nixpkgs overrides.

Type: attribute set of unspecifieds

Default

{}

specialArgs

A set of special arguments to be passed to NixOS modules.

This will be merged into the specialArgs used to evaluate the NixOS configurations.

Type: attribute set of unspecifieds

Default

{}