nixos-config/docs/content/en-US/04-nixos-modules/02-workflows/index.adoc

1.9 KiB
Raw Blame History


title: Workflows --- = Workflows

Workflows are an all-encompassing NixOS module for dictating how you interact with your computer/device/whatever. Basically, this is where certain things are set such as your GNOME desktop environment settings, your dolled up standalone window manager setup, or an oddball audio-only desktop interface. They are located in ./nixos/modules/workflows at the project root.

Workflows are defined under the namespace workflows where each workflow module is set to be declared and to be enabled at workflows.workflows.<name>. For example, heres how I would enable my (hypothetical) GNOME desktop workflow.

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

{
  workflows.workflows.a-happy-gnome.enable = true;
}

Take note you cannot enable more than two workflows at any given time.

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

{
  # This would cause an assertion error.
  workflows.workflows = {
    a-happy-gnome.enable = true;
    knome.enable = true;
  };
}

You can get around this by setting workflows.disableLimit to true. However, this shouldnt be taken lightly as workflow modules are very vast in scope and are expected to set system settings that can affect your hardware including…

  • Enabling (and/or disabling) system services such as the preferred network manager.

  • Modifying the list of installed applications.

  • Setting up programs with custom configurations which could cause conflicts with the defaults (upstream or from nixpkgs).

By organizing the workflow modules this way, you can easily create your desktop rices without overlapping system settings. Bless the Nix module system!

Whether those rices are worth posting to Unix ricing communities is up to you though.

Whippersnappers with your "riced"-up systems…