[eveeifyeve]

Caution

This pull request is still being cleaned up and is not fully production ready, use at your own risk.

This pull request adds user creation/specification support to modular services! This allows you to introduce services built with specific users, userid, group and group id and adds further support for future API's such as runtimeDirectory, cacheDirectory stateDirectory, logDirectory in future.

Things done

• Fits CONTRIBUTING.md, pkgs/README.md, maintainers/README.md and other READMEs.
• Follows the automation/AI policy.
• Built on platform:
  • x86_64-linux
  • aarch64-linux
  • aarch64-darwin
• Tested, as applicable:
  • Basic functionality of all binary files, usually in ./result/bin/.
  • Ran nixpkgs-review on this PR. See nixpkgs-review usage.
  • Package tests at passthru.tests.
  • NixOS tests in nixos/tests.
  • Tests in lib/tests or pkgs/test for functions and "core" functionality.
• Nixpkgs Release Notes
  • Package update: when the change is major or breaking.
• NixOS Release Notes
  • Module addition: when adding a new NixOS module.
  • Module update: when the change is significant.
• Validated with the following use cases:
  • simple, no users
  • services with same-user constraints but no names or ids. Names can be derived from the service attribute path. Ids use existing solutions like NixOS id-less users (mutable-users or otherwise).
  • services with user names
  • services with all information pinned down
  • services with ids pinned down but not using default names

[github-actions]

Thanks for contributing to the documentation.

Follow the documentation style guide, especially:

• Show, don’t tell. Start with a minimal working example. Explain after the code.
• Avoid meta-commentary. Don’t write "This section explains how to…".
• Use present tense, imperative mood, and active voice. For example: "Run the command," not "The user should run the following command."
• Avoid vague references like "this" when the referent is unclear. Write "This command creates a folder," not "This will create a folder."
• Be direct. Avoid "should", "might", "typically", and "usually".
• Cut filler words like "simply", "just", "easily", and "basically". Use "to" instead of "in order to".

For larger changes, such as adding or removing whole sections, ask the NixOS documentation team for review.

[eveeifyeve]

CC @aanderse for review.

[roberth]

Just a partial review

Main things left to do:

• Review the prose critically
• Validate the interface by applying it in diverse scenarios

[eveeifyeve]

Moving to nixpkgs, as I consider this ready for a pr to nixpkgs.

[eveeifyeve]

NixOS#579760