Mjolnir
services.mjolnir.accessTokenFile
File containing the matrix access token for the mjolnir
user.
Type: null or path
Default
null
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.dataPath
The directory the bot should store various bits of information in.
Type: path
Default
"/var/lib/mjolnir"
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.enable
Whether to enable Mjolnir, a moderation tool for Matrix.
Type: boolean
Default
false
Example
true
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.homeserverUrl
Where the homeserver is located (client-server URL).
If pantalaimon.enable
is true
, this option will become the homeserver to which pantalaimon
connects.
The listen address of pantalaimon
will then become the homeserverUrl
of mjolnir
.
Type: string
Default
"https://matrix.org"
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.managementRoom
The room ID where people can use the bot. The bot has no access controls, so
anyone in this room can use the bot - secure your room!
This should be a room alias or room ID - not a matrix.to URL.
Note: mjolnir
is fairly verbose - expect a lot of messages from it.
Type: string
Default
"#moderators:example.org"
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon
pantalaimon
options (enables E2E Encryption support).
This will create a pantalaimon
instance with the name "mjolnir".
Type: submodule
Default
{ }
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.enable
Whether to enable ignoring the accessToken. If true, accessToken is ignored and the username/password below will be
used instead. The access token of the bot will be stored in the dataPath
.
Type: boolean
Default
false
Example
true
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options
passthrough additional options to the pantalaimon
service.
Type: submodule
Default
{ }
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options.dataPath
The directory where pantalaimon
should store its state such as the database file.
Type: path
Default
"/var/lib/pantalaimon-‹name›"
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options.extraSettings
Extra configuration options. See pantalaimon(5) for available options.
Type: attribute set
Default
{ }
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options.homeserver
The URI of the homeserver that the pantalaimon
proxy should
forward requests to, without the matrix API path but including
the http(s) schema.
Type: string
Example
"https://matrix.org"
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options.listenAddress
The address where the daemon will listen to client connections for this homeserver.
Type: string
Default
"localhost"
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options.listenPort
The port where the daemon will listen to client connections for this homeserver. Note that the listen address/port combination needs to be unique between different homeservers.
Type: 16 bit unsigned integer; between 0 and 65535 (both inclusive)
Default
8009
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options.logLevel
Set the log level of the daemon.
Type: one of "info", "warning", "error", "debug"
Default
"warning"
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.options.ssl
Whether or not SSL verification should be enabled for outgoing connections to the homeserver.
Type: boolean
Default
true
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.passwordFile
File containing the matrix password for the mjolnir
user.
Type: null or path
Default
null
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.pantalaimon.username
The username to login with.
Type: string
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.protectedRooms
A list of rooms to protect (matrix.to URLs).
Type: list of string
Default
[ ]
Example
["https://matrix.to/#/#yourroom:example.org""https://matrix.to/#/#anotherroom:example.org"]
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix
services.mjolnir.settings
Additional settings (see mjolnir default config for available settings). These settings will override settings made by the module config.
Type: YAML value
Default
{ }
Example
{autojoinOnlyIfManager = true;automaticallyRedactForReasons = [ "spam" "advertising" ];}
Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/matrix/mjolnir.nix