about summary refs log tree commit diff
path: root/nixos/modules/services/mail/mailcatcher.nix
blob: 6728bbcd3b8e25e4dc3a746f072a574bb66b602a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
{ config, pkgs, lib, ... }:

let
  cfg = config.services.mailcatcher;

  inherit (lib) mkEnableOption mkIf mkOption types optionalString;
in
{
  # interface

  options = {

    services.mailcatcher = {
      enable = mkEnableOption "MailCatcher, an SMTP server and web interface to locally test outbound emails";

      http.ip = mkOption {
        type = types.str;
        default = "127.0.0.1";
        description = "The ip address of the http server.";
      };

      http.port = mkOption {
        type = types.port;
        default = 1080;
        description = "The port address of the http server.";
      };

      http.path = mkOption {
        type = with types; nullOr str;
        default = null;
        description = "Prefix to all HTTP paths.";
        example = "/mailcatcher";
      };

      smtp.ip = mkOption {
        type = types.str;
        default = "127.0.0.1";
        description = "The ip address of the smtp server.";
      };

      smtp.port = mkOption {
        type = types.port;
        default = 1025;
        description = "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";
      };
    };
  };
}