nixpkgs/nixos/modules/services/mail/mailcatcher.nix
pennae ef176dcf7e nixos/*: automatically convert option descriptions
conversions were done using https://github.com/pennae/nix-doc-munge
using (probably) rev f34e145 running

    nix-doc-munge nixos/**/*.nix
    nix-doc-munge --import nixos/**/*.nix

the tool ensures that only changes that could affect the generated
manual *but don't* are committed, other changes require manual review
and are discarded.
2022-08-31 16:32:53 +02:00

69 lines
1.8 KiB
Nix

{ config, pkgs, lib, ... }:
let
cfg = config.services.mailcatcher;
inherit (lib) mkEnableOption mkIf mkOption types optionalString;
in
{
# interface
options = {
services.mailcatcher = {
enable = mkEnableOption (lib.mdDoc "MailCatcher");
http.ip = mkOption {
type = types.str;
default = "127.0.0.1";
description = lib.mdDoc "The ip address of the http server.";
};
http.port = mkOption {
type = types.port;
default = 1080;
description = lib.mdDoc "The port address of the http server.";
};
http.path = mkOption {
type = with types; nullOr str;
default = null;
description = lib.mdDoc "Prefix to all HTTP paths.";
example = "/mailcatcher";
};
smtp.ip = mkOption {
type = types.str;
default = "127.0.0.1";
description = lib.mdDoc "The ip address of the smtp server.";
};
smtp.port = mkOption {
type = types.port;
default = 1025;
description = lib.mdDoc "The port address of the smtp server.";
};
};
};
# implementation
config = mkIf cfg.enable {
environment.systemPackages = [ pkgs.mailcatcher ];
systemd.services.mailcatcher = {
description = "MailCatcher Service";
after = [ "network.target" ];
wantedBy = [ "multi-user.target" ];
serviceConfig = {
DynamicUser = true;
Restart = "always";
ExecStart = "${pkgs.mailcatcher}/bin/mailcatcher --foreground --no-quit --http-ip ${cfg.http.ip} --http-port ${toString cfg.http.port} --smtp-ip ${cfg.smtp.ip} --smtp-port ${toString cfg.smtp.port}" + optionalString (cfg.http.path != null) " --http-path ${cfg.http.path}";
AmbientCapabilities = optionalString (cfg.http.port < 1024 || cfg.smtp.port < 1024) "cap_net_bind_service";
};
};
};
}