mirror of
https://github.com/nix-community/home-manager.git
synced 2026-06-05 21:02:51 +00:00
Adds `home.services`, an attribute set of nixpkgs [modular services](https://nixos.org/manual/nixos/unstable/#modular-services) sourced from `<nixpkgs/lib/services/lib.nix>`. Each service exposes `process.argv` and the upstream NixOS-style systemd schema (`systemd.lib`, `systemd.mainExecStart`, `systemd.service`, `systemd.services`, `systemd.sockets`) by re-exporting `nixos/modules/system/service/systemd/service.nix`. Service modules shipped with `_class = "service"` (e.g. `pkgs.<name>.passthru.services.default`) drop in unchanged -- service portability across module systems is the point of modular services. Lifted units are evaluated and translated from NixOS-style attrs (`wantedBy`, `serviceConfig`, `unitConfig`, `environment`, ...) into the section-based INI shape (`{ Unit; Service; Install; }`) that home-manager's `systemd.user.{services,sockets}` consumes; only the common keys are mapped, uncommon options remain reachable via `unitConfig` / `serviceConfig` / `socketConfig`. Sub-services and their units are dashed under the parent service name; `process.argv` becomes the default `ExecStart` for the service's primary unit, which defaults to `WantedBy=default.target`. Mirrors the surface of nixpkgs' portable systemd module (services + sockets only); other unit kinds home-manager supports natively (timers etc.) are intentionally not modeled until upstream grows them. Each service's `configData.<name>` entries are materialized at `$XDG_CONFIG_HOME/system-services/<service-prefix>/<name>` (mirroring how `nixos/modules/system/service/systemd/{config-data-path,system}.nix` lifts `configData` to `environment.etc`), with the absolute path injected back into `configData.<name>.path` so the service can refer to its files at a stable location. Includes nmt tests covering: a basic `process.argv`-only service, a service with a `configData` entry, and importing `pkgs.ghostunnel.passthru.services.default` to assert the lifted user unit contains the expected ExecStart flags and `LoadCredential` entries.
23 lines
905 B
Nix
23 lines
905 B
Nix
# Per-service extension module loaded into every `home.services` entry.
|
|
#
|
|
# Re-exports the nixpkgs portable systemd service module so HM modular
|
|
# services accept the same NixOS-style schema (`systemd.lib`,
|
|
# `systemd.mainExecStart`, `systemd.service`, `systemd.services`,
|
|
# `systemd.sockets`) as their NixOS counterparts. This is what lets
|
|
# upstream service modules (e.g. `pkgs.<name>.passthru.services.default`)
|
|
# drop in unchanged. Then overrides the primary unit's `wantedBy` default
|
|
# to `default.target`, since user units typically attach to that instead
|
|
# of `multi-user.target`.
|
|
{ lib, nixpkgsPath, ... }:
|
|
{
|
|
imports = [
|
|
(nixpkgsPath + "/nixos/modules/system/service/systemd/service.nix")
|
|
];
|
|
|
|
# The empty key `""` is the modular service's *primary* unit (see
|
|
# `dashed` in `default.nix`).
|
|
config.systemd.services."" = {
|
|
wantedBy = lib.mkOverride 950 [ "default.target" ];
|
|
};
|
|
}
|