commit a4c4060efbbf07159cf24d6a14a7a8cb90043ea0 · pyrox.dev/nixpkgs

nixos/modules/module-list.nix

···

       477
        
         ./services/mail/roundcube.nix

     

       478
        
         ./services/mail/sympa.nix

     

       479
        
         ./services/mail/nullmailer.nix

     

       0
        
       
     

       480
        
         ./services/matrix/pantalaimon.nix

     

       481
        
         ./services/misc/airsonic.nix

     

       482
        
         ./services/misc/ankisyncd.nix

···

       477
        
         ./services/mail/roundcube.nix

     

       478
        
         ./services/mail/sympa.nix

     

       479
        
         ./services/mail/nullmailer.nix

     

       480
       +
         ./services/matrix/mjolnir.nix

     

       481
        
         ./services/matrix/pantalaimon.nix

     

       482
        
         ./services/misc/airsonic.nix

     

       483
        
         ./services/misc/ankisyncd.nix

+239

nixos/modules/services/matrix/mjolnir.nix

···

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

     

       2
       +
       

     

       3
       +
       with lib;

     

       4
       +
       let

     

       5
       +
         cfg = config.services.mjolnir;

     

       6
       +
       

     

       7
       +
         yamlConfig = {

     

       8
       +
           inherit (cfg) dataPath managementRoom protectedRooms;

     

       9
       +
       

     

       10
       +
           accessToken = "@ACCESS_TOKEN@"; # will be replaced in "generateConfig"

     

       11
       +
           homeserverUrl =

     

       12
       +
             if cfg.pantalaimon.enable then

     

       13
       +
               "http://${cfg.pantalaimon.options.listenAddress}:${toString cfg.pantalaimon.options.listenPort}"

     

       14
       +
             else

     

       15
       +
               cfg.homeserverUrl;

     

       16
       +
       

     

       17
       +
           pantalaimon = {

     

       18
       +
             inherit (cfg.pantalaimon) username;

     

       19
       +
       

     

       20
       +
             use = cfg.pantalaimon.enable;

     

       21
       +
             password = "@PANTALAIMON_PASSWORD@"; # will be replaced in "generateConfig"

     

       22
       +
           };

     

       23
       +
         };

     

       24
       +
       

     

       25
       +
         moduleConfigFile = pkgs.writeText "module-config.yaml" (

     

       26
       +
           generators.toYAML { } (filterAttrs (_: v: v != null)

     

       27
       +
             (fold recursiveUpdate { } [ yamlConfig cfg.settings ])));

     

       28
       +
       

     

       29
       +
         # these config files will be merged one after the other to build the final config

     

       30
       +
         configFiles = [

     

       31
       +
           "${pkgs.mjolnir}/share/mjolnir/config/default.yaml"

     

       32
       +
           moduleConfigFile

     

       33
       +
         ];

     

       34
       +
       

     

       35
       +
         # this will generate the default.yaml file with all configFiles as inputs and

     

       36
       +
         # replace all secret strings using replace-secret

     

       37
       +
         generateConfig = pkgs.writeShellScript "mjolnir-generate-config" (

     

       38
       +
           let

     

       39
       +
             yqEvalStr = concatImapStringsSep " * " (pos: _: "select(fileIndex == ${toString (pos - 1)})") configFiles;

     

       40
       +
             yqEvalArgs = concatStringsSep " " configFiles;

     

       41
       +
           in

     

       42
       +
           ''

     

       43
       +
             set -euo pipefail

     

       44
       +
       

     

       45
       +
             umask 077

     

       46
       +
       

     

       47
       +
             # mjolnir will try to load a config from "./config/default.yaml" in the working directory

     

       48
       +
             # -> let's place the generated config there

     

       49
       +
             mkdir -p ${cfg.dataPath}/config

     

       50
       +
       

     

       51
       +
             # merge all config files into one, overriding settings of the previous one with the next config

     

       52
       +
             # e.g. "eval-all 'select(fileIndex == 0) * select(fileIndex == 1)' filea.yaml fileb.yaml" will merge filea.yaml with fileb.yaml

     

       53
       +
             ${pkgs.yq-go}/bin/yq eval-all -P '${yqEvalStr}' ${yqEvalArgs} > ${cfg.dataPath}/config/default.yaml

     

       54
       +
       

     

       55
       +
             ${optionalString (cfg.accessTokenFile != null) ''

     

       56
       +
               ${pkgs.replace-secret}/bin/replace-secret '@ACCESS_TOKEN@' '${cfg.accessTokenFile}' ${cfg.dataPath}/config/default.yaml

     

       57
       +
             ''}

     

       58
       +
             ${optionalString (cfg.pantalaimon.passwordFile != null) ''

     

       59
       +
               ${pkgs.replace-secret}/bin/replace-secret '@PANTALAIMON_PASSWORD@' '${cfg.pantalaimon.passwordFile}' ${cfg.dataPath}/config/default.yaml

     

       60
       +
             ''}

     

       61
       +
           ''

     

       62
       +
         );

     

       63
       +
       in

     

       64
       +
       {

     

       65
       +
         options.services.mjolnir = {

     

       66
       +
           enable = mkEnableOption "Mjolnir, a moderation tool for Matrix";

     

       67
       +
       

     

       68
       +
           homeserverUrl = mkOption {

     

       69
       +
             type = types.str;

     

       70
       +
             default = "https://matrix.org";

     

       71
       +
             description = ''

     

       72
       +
               Where the homeserver is located (client-server URL).

     

       73
       +
       

     

       74
       +
               If <literal>pantalaimon.enable</literal> is <literal>true</literal>, this option will become the homeserver to which <literal>pantalaimon</literal> connects.

     

       75
       +
               The listen address of <literal>pantalaimon</literal> will then become the <literal>homeserverUrl</literal> of <literal>mjolnir</literal>.

     

       76
       +
             '';

     

       77
       +
           };

     

       78
       +
       

     

       79
       +
           accessTokenFile = mkOption {

     

       80
       +
             type = with types; nullOr path;

     

       81
       +
             default = null;

     

       82
       +
             description = ''

     

       83
       +
               File containing the matrix access token for the <literal>mjolnir</literal> user.

     

       84
       +
             '';

     

       85
       +
           };

     

       86
       +
       

     

       87
       +
           pantalaimon = mkOption {

     

       88
       +
             description = ''

     

       89
       +
               <literal>pantalaimon</literal> options (enables E2E Encryption support).

     

       90
       +
       

     

       91
       +
               This will create a <literal>pantalaimon</literal> instance with the name "mjolnir".

     

       92
       +
             '';

     

       93
       +
             default = { };

     

       94
       +
             type = types.submodule {

     

       95
       +
               options = {

     

       96
       +
                 enable = mkEnableOption ''

     

       97
       +
                   If true, accessToken is ignored and the username/password below will be

     

       98
       +
                   used instead. The access token of the bot will be stored in the dataPath.

     

       99
       +
                 '';

     

       100
       +
       

     

       101
       +
                 username = mkOption {

     

       102
       +
                   type = types.str;

     

       103
       +
                   description = "The username to login with.";

     

       104
       +
                 };

     

       105
       +
       

     

       106
       +
                 passwordFile = mkOption {

     

       107
       +
                   type = with types; nullOr path;

     

       108
       +
                   default = null;

     

       109
       +
                   description = ''

     

       110
       +
                     File containing the matrix password for the <literal>mjolnir</literal> user.

     

       111
       +
                   '';

     

       112
       +
                 };

     

       113
       +
       

     

       114
       +
                 options = mkOption {

     

       115
       +
                   type = types.submodule (import ./pantalaimon-options.nix);

     

       116
       +
                   default = { };

     

       117
       +
                   description = ''

     

       118
       +
                     passthrough additional options to the <literal>pantalaimon</literal> service.

     

       119
       +
                   '';

     

       120
       +
                 };

     

       121
       +
               };

     

       122
       +
             };

     

       123
       +
           };

     

       124
       +
       

     

       125
       +
           dataPath = mkOption {

     

       126
       +
             type = types.path;

     

       127
       +
             default = "/var/lib/mjolnir";

     

       128
       +
             description = ''

     

       129
       +
               The directory the bot should store various bits of information in.

     

       130
       +
             '';

     

       131
       +
           };

     

       132
       +
       

     

       133
       +
           managementRoom = mkOption {

     

       134
       +
             type = types.str;

     

       135
       +
             default = "#moderators:example.org";

     

       136
       +
             description = ''

     

       137
       +
               The room ID where people can use the bot. The bot has no access controls, so

     

       138
       +
               anyone in this room can use the bot - secure your room!

     

       139
       +
               This should be a room alias or room ID - not a matrix.to URL.

     

       140
       +
               Note: <literal>mjolnir</literal> is fairly verbose - expect a lot of messages from it.

     

       141
       +
             '';

     

       142
       +
           };

     

       143
       +
       

     

       144
       +
           protectedRooms = mkOption {

     

       145
       +
             type = types.listOf types.str;

     

       146
       +
             default = [ ];

     

       147
       +
             example = literalExample ''

     

       148
       +
               [

     

       149
       +
                 "https://matrix.to/#/#yourroom:example.org"

     

       150
       +
                 "https://matrix.to/#/#anotherroom:example.org"

     

       151
       +
               ]

     

       152
       +
             '';

     

       153
       +
             description = ''

     

       154
       +
               A list of rooms to protect (matrix.to URLs).

     

       155
       +
             '';

     

       156
       +
           };

     

       157
       +
       

     

       158
       +
           settings = mkOption {

     

       159
       +
             default = { };

     

       160
       +
             type = (pkgs.formats.yaml { }).type;

     

       161
       +
             example = literalExample ''

     

       162
       +
               {

     

       163
       +
                 autojoinOnlyIfManager = true;

     

       164
       +
                 automaticallyRedactForReasons = [ "spam" "advertising" ];

     

       165
       +
               }

     

       166
       +
             '';

     

       167
       +
             description = ''

     

       168
       +
               Additional settings (see <link xlink:href="https://github.com/matrix-org/mjolnir/blob/main/config/default.yaml">mjolnir default config</link> for available settings). These settings will override settings made by the module config.

     

       169
       +
             '';

     

       170
       +
           };

     

       171
       +
         };

     

       172
       +
       

     

       173
       +
         config = mkIf config.services.mjolnir.enable {

     

       174
       +
           assertions = [

     

       175
       +
             {

     

       176
       +
               assertion = !(cfg.pantalaimon.enable && cfg.pantalaimon.passwordFile == null);

     

       177
       +
               message = "Specify pantalaimon.passwordFile";

     

       178
       +
             }

     

       179
       +
             {

     

       180
       +
               assertion = !(cfg.pantalaimon.enable && cfg.accessTokenFile != null);

     

       181
       +
               message = "Do not specify accessTokenFile when using pantalaimon";

     

       182
       +
             }

     

       183
       +
             {

     

       184
       +
               assertion = !(!cfg.pantalaimon.enable && cfg.accessTokenFile == null);

     

       185
       +
               message = "Specify accessTokenFile when not using pantalaimon";

     

       186
       +
             }

     

       187
       +
           ];

     

       188
       +
       

     

       189
       +
           services.pantalaimon-headless.instances."mjolnir" = mkIf cfg.pantalaimon.enable

     

       190
       +
             {

     

       191
       +
               homeserver = cfg.homeserverUrl;

     

       192
       +
             } // cfg.pantalaimon.options;

     

       193
       +
       

     

       194
       +
           systemd.services.mjolnir = {

     

       195
       +
             description = "mjolnir - a moderation tool for Matrix";

     

       196
       +
             wants = [ "network-online.target" ] ++ optionals (cfg.pantalaimon.enable) [ "pantalaimon-mjolnir.service" ];

     

       197
       +
             after = [ "network-online.target" ] ++ optionals (cfg.pantalaimon.enable) [ "pantalaimon-mjolnir.service" ];

     

       198
       +
             wantedBy = [ "multi-user.target" ];

     

       199
       +
       

     

       200
       +
             serviceConfig = {

     

       201
       +
               ExecStart = ''${pkgs.mjolnir}/bin/mjolnir'';

     

       202
       +
               ExecStartPre = [ generateConfig ];

     

       203
       +
               WorkingDirectory = cfg.dataPath;

     

       204
       +
               StateDirectory = "mjolnir";

     

       205
       +
               StateDirectoryMode = "0700";

     

       206
       +
               ProtectSystem = "strict";

     

       207
       +
               ProtectHome = true;

     

       208
       +
               PrivateTmp = true;

     

       209
       +
               NoNewPrivileges = true;

     

       210
       +
               PrivateDevices = true;

     

       211
       +
               User = "mjolnir";

     

       212
       +
               Restart = "on-failure";

     

       213
       +
       

     

       214
       +
               /* TODO: wait for #102397 to be resolved. Then load secrets from $CREDENTIALS_DIRECTORY+"/NAME"

     

       215
       +
               DynamicUser = true;

     

       216
       +
               LoadCredential = [] ++

     

       217
       +
                 optionals (cfg.accessTokenFile != null) [

     

       218
       +
                   "access_token:${cfg.accessTokenFile}"

     

       219
       +
                 ] ++

     

       220
       +
                 optionals (cfg.pantalaimon.passwordFile != null) [

     

       221
       +
                   "pantalaimon_password:${cfg.pantalaimon.passwordFile}"

     

       222
       +
                 ];

     

       223
       +
               */

     

       224
       +
             };

     

       225
       +
           };

     

       226
       +
       

     

       227
       +
           users = {

     

       228
       +
             users.mjolnir = {

     

       229
       +
               group = "mjolnir";

     

       230
       +
               isSystemUser = true;

     

       231
       +
             };

     

       232
       +
             groups.mjolnir = { };

     

       233
       +
           };

     

       234
       +
         };

     

       235
       +
       

     

       236
       +
         meta = {

     

       237
       +
           maintainers = with maintainers; [ jojosch ];

     

       238
       +
         };

     

       239
       +
       }