commit 4c465eb8ba699b11ee3814cd7eb7c1f62a8fbfc7 Author: Daniel Olsen Date: Sun Oct 18 23:08:50 2020 +0200 init diff --git a/synapse-module/default.nix b/synapse-module/default.nix new file mode 100644 index 0000000..397b6cc --- /dev/null +++ b/synapse-module/default.nix @@ -0,0 +1,469 @@ +{ lib, pkgs, config, ... }: + +let + cfg = config.services.matrix-synapse-next; + format = pkgs.formats.yaml {}; + matrix-synapse-common-config = format.generate "matrix-synapse-common-config.yaml" cfg.settings; + pluginsEnv = cfg.package.python.buildEnv.override { + extraLibs = cfg.plugins; + }; +in +{ + options.services.matrix-synapse-next = { + enable = lib.mkEnableOption "matrix-synapse"; + + package = lib.mkOption { + type = lib.types.package; + default = pkgs.matrix-synapse; + }; + + plugins = lib.mkOption { + type = lib.types.listOf lib.types.package; + default = [ ]; + example = lib.literalExample '' + with config.services.matrix-synapse-advanced.package.plugins; [ + matrix-synapse-ldap3 + matrix-synapse-pam + ]; + ''; + description = '' + List of additional Matrix plugins to make available. + ''; + }; + + dataDir = lib.mkOption { + type = lib.types.str; + default = "/var/lib/matrix-synapse"; + description = '' + The directory where matrix-synapse stores its stateful data such as + certificates, media and uploads. + ''; + }; + + enableMainSynapse = lib.mkOption { + type = lib.types.bool; + default = true; + description = '' + Enable the main synapse process. + Useful if running workers on separate computers. + ''; + }; + + mainLogConfig = lib.mkOption { + type = lib.types.lines; + description = "A yaml python logging config file"; + default = lib.readFile ./matrix-synapse-log_config.yaml; + }; + + workers = lib.mkOption { + type = lib.types.attrsOf (lib.types.submodule ({config, ...}: { + options.settings = lib.mkOption { + type = lib.types.submodule { + freeformType = format.type; + + options.worker_app = lib.mkOption { + type = lib.types.enum [ + "synapse.app.generic_worker" + "synapse.app.pusher" + "synapse.app.appservice" + "synapse.app.federation_sender" + "synapse.app.media_repository" + "synapse.app.user_dir" + "synapse.app.frontend_proxy" + ]; + description = "The type of worker application"; + }; + options.worker_replication_host = lib.mkOption { + type = lib.types.str; + description = "The replication listeners ip on the main synapse process"; + default = "127.0.0.1"; + }; + options.worker_replication_http_port = lib.mkOption { + type = lib.types.port; + description = "The replication listeners port on the main synapse process"; + }; + options.worker_listeners = lib.mkOption { + type = lib.types.listOf (lib.types.submodule { + options.type = lib.mkOption { + type = lib.types.enum [ "http" "metrics" ]; + description = "The type of the listener"; + default = "http"; + }; + options.port = lib.mkOption { + type = lib.types.port; + description = "the TCP port to bind to"; + }; + options.resources = lib.mkOption { + type = lib.types.listOf (lib.types.submodule { + options.names = lib.mkOption { + type = lib.types.listOf (lib.types.enum [ "client" "consent" "federation" "keys" "media" "metrics" "openid" "replication" "static" "webclient" ]); + description = "A list of resources to host on this port"; + }; + options.compress = lib.mkOption { + type = lib.types.bool; + description = "enable HTTP compression for this resource"; + default = false; + }; + }); + }; + }); + description = "Listener configuration for the worker, similar to the main synapse listener"; + default = []; + }; + }; + }; + })); + default = {}; + description = "Worker configuration"; + example = { + "federation_sender1" = { + settings = { + worker_name = "federation_sender1"; + worker_app = "synapse.app.federation_sender"; + + worker_replication_host = "127.0.0.1"; + worker_replication_http_port = 9093; + worker_listeners = [ ]; + }; + }; + }; + }; + + settings = lib.mkOption { + type = lib.types.submodule { + freeformType = format.type; + + options.server_name = lib.mkOption { + type = lib.types.str; + description = '' + The server_name name will appear at the end of usernames and room addresses + created on this server. For example if the server_name was example.com, + usernames on this server would be in the format @user:example.com + + In most cases you should avoid using a matrix specific subdomain such as + matrix.example.com or synapse.example.com as the server_name for the same + reasons you wouldn't use user@email.example.com as your email address. + See https://github.com/matrix-org/synapse/blob/master/docs/delegate.md + for information on how to host Synapse on a subdomain while preserving + a clean server_name. + + The server_name cannot be changed later so it is important to + configure this correctly before you start Synapse. It should be all + lowercase and may contain an explicit port. + ''; + example = "matrix.org"; + }; + + options.pid_file = lib.mkOption { + type = lib.types.path; + description = "When running as a daemon, the file to store the pid in"; + default = "/run/matrix-synapse.pid"; + }; + + options.use_presence = lib.mkOption { + type = lib.types.bool; + description = "disable presence tracking on this homeserver, if you're having perfomance issues this can have a big impact"; + default = true; + }; + + options.listeners = lib.mkOption { + type = lib.types.listOf (lib.types.submodule { + options.port = lib.mkOption { + type = lib.types.port; + description = "the TCP port to bind to"; + example = 8448; + }; + options.bind_addresses = lib.mkOption { + type = lib.types.listOf lib.types.str; + description = "A list of local addresses to listen on"; + }; + options.type = lib.mkOption { + type = lib.types.enum [ "http" "manhole" "metrics" "replication" ]; + description = "The type of the listener"; + default = "http"; + }; + options.tls = lib.mkOption { + type = lib.types.bool; + description = "set to true to enable TLS for this listener. Will use the TLS key/cert specified in tls_private_key_path / tls_certificate_path."; + default = true; + }; + options.x_forwarded = lib.mkOption { + type = lib.types.bool; + description = '' + Only valid for an 'http' listener. Set to true to use the X-Forwarded-For header as the client IP. + Useful when Synapse is behind a reverse-proxy. + ''; + default = false; + }; + options.resources = lib.mkOption { + type = lib.types.listOf (lib.types.submodule { + options.names = lib.mkOption { + type = lib.types.listOf (lib.types.enum [ "client" "consent" "federation" "keys" "media" "metrics" "openid" "replication" "static" "webclient" ]); + description = "A list of resources to host on this port"; + }; + options.compress = lib.mkOption { + type = lib.types.bool; + description = "enable HTTP compression for this resource"; + default = false; + }; + }); + }; + }); + description = "List of ports that Synapse should listen on, their purpose and their configuration"; + default = [ + { + port = 8448; + bind_addresses = [ "0.0.0.0" "::" ]; + resources = [ + { names = [ "client" ]; compress = true; } + { names = [ "federation" ]; compress = false; } + ]; + } + ]; + }; + options.acme = { + enable = lib.mkOption { + type = lib.types.bool; + description = "ACME support requires tls_certificate_path and tls_private_key_path to be set"; + default = false; + }; + port = lib.mkOption { + type = lib.types.port; + description = "Port number to listen on for the HTTP-01 challenge. Change this if you are forwarding connections through Apache/Nginx/etc."; + default = 80; + }; + bind_addresses = lib.mkOption { + type = lib.types.listOf lib.types.str; + description = '' + Local addresses to listen on for incoming connections. + Again, you may want to change this if you are forwarding connections + through Apache/Nginx/etc."; + ''; + default = [ "0.0.0.0" "::"]; + }; + reprovision_threshold = lib.mkOption { + type = lib.types.ints.positive; + description = "How many days remaining on a certificate before it is renewed"; + default = 30; + }; + domain = lib.mkOption { + type = lib.types.str; + description = '' + The domain that the certificate should be for. Normally this + should be the same as your Matrix domain (i.e., 'server_name'), but, + by putting a file at 'https:///.well-known/matrix/server', + you can delegate incoming traffic to another server. If you do that, + you should give the target of the delegation here. + + For example: if your 'server_name' is 'example.com', but + 'https://example.com/.well-known/matrix/server' delegates to + 'matrix.example.com', you should put 'matrix.example.com' here. + ''; + default = cfg.settings.server_name; + }; + account_key_file = lib.mkOption { + type = lib.types.path; + description = "file to use for the account key, will be generated if it doesn't exist"; + default = cfg.dataDir + "/acme_account.key"; + }; + }; + options.federation_ip_range_blacklist = lib.mkOption { + type = lib.types.listOf lib.types.str; + description = '' + Prevent federation requests from being sent to the following + blacklist IP address CIDR ranges. If this option is not specified, or + specified with an empty list, no ip range blacklist will be enforced. + ''; + default = [ + "127.0.0.0/8" + "10.0.0.0/8" + "172.16.0.0/12" + "192.168.0.0/16" + "100.64.0.0/10" + "169.254.0.0/16" + "::1/128" + "fe80::/64" + "fc00::/7" + ]; + }; + options.log_config = lib.mkOption { + type = lib.types.path; + description = '' + A yaml python logging config file as described by + https://docs.python.org/3.7/library/logging.config.html#configuration-dictionary-schema + ''; + default = pkgs.writeText "log_config.yaml" cfg.mainLogConfig; + }; + + options.media_store_path = lib.mkOption { + type = lib.types.path; + description = "Directory where uploaded images and attachments are stored"; + default = cfg.dataDir + "/media_store"; + }; + options.max_upload_size = lib.mkOption { + type = lib.types.str; + description = "The largest allowed upload size in bytes"; + default = "50M"; + }; + + options.enable_registration = lib.mkOption { + type = lib.types.bool; + description = "Enable registration for new users"; + default = true; + }; + + options.enable_metrics = lib.mkOption { + type = lib.types.bool; + description = "Enable collection and rendering of performance metrics"; + default = false; + }; + options.report_stats = lib.mkOption { + type = lib.types.bool; + description = "TODO: Enable and Disable reporting usage stats"; + default = false; + }; + + options.app_service_config_files = lib.mkOption { + type = lib.types.listOf lib.types.path; + description = "A list of application service config files to use"; + default = []; + }; + + options.signing_key_path = lib.mkOption { + type = lib.types.path; + description = "Path to the signing key to sign messages with"; + default = cfg.dataDir + "/" +cfg.settings.server_name + ".signing.key"; + }; + + options.trusted_key_servers = lib.mkOption { + type = lib.types.listOf (lib.types.submodule { + freeformType = format.type; + + options.server_name = lib.mkOption { + type = lib.types.str; + description = "the name of the server. required"; + }; + }); + description = "The trusted servers to download signing keys from"; + default = [ + { + server_name = "matrix.org"; + verify_keys."ed25519:auto" = "Noi6WqcDj0QmPxCNQqgezwTlBKrfqehY1u2FyWP9uYw"; + } + ]; + }; + options.suppress_key_server_warning = lib.mkOption { + type = lib.types.bool; + description = "using matrix.org as a trusted key server will generate a warning if this is false"; + default = false; + }; + + options.send_federation = lib.mkOption { + type = lib.types.bool; + description = "Disables sending of outbound federation transactions on the main process. Set to false if using federation senders"; + default = (lib.lists.count (x: true) cfg.settings.federation_sender_instances) == 0; + }; + + options.federation_sender_instances = lib.mkOption { + type = lib.types.listOf lib.types.str; + description = '' + This configuration must be shared between all federation sender workers, and if + changed all federation sender workers must be stopped at the same time and then + started, to ensure that all instances are running with the same config (otherwise + events may be dropped) + ''; + default = []; + }; + }; + }; + + extraConfigFiles = lib.mkOption { + type = lib.types.listOf lib.types.path; + default = []; + description = '' + Extra config files to include. + The configuration files will be included based on the command line + argument --config-path. This allows to configure secrets without + having to go through the Nix store, e.g. based on deployment keys if + NixOPS is in use. + ''; + }; + + }; + + config = lib.mkIf cfg.enable (lib.mkMerge [ + ({ + users.users.matrix-synapse = { + group = "matrix-synapse"; + home = cfg.dataDir; + createHome = true; + shell = "${pkgs.bash}/bin/bash"; + uid = config.ids.uids.matrix-synapse; + }; + users.groups.matrix-synapse = { + gid = config.ids.gids.matrix-synapse; + }; + }) + + (lib.mkIf cfg.enableMainSynapse { + systemd.services.matrix-synapse = { + description = "Synapse Matrix homeserver"; + after = [ "network.target" ]; + wantedBy = [ "multi-user.target" ]; + preStart = '' + ${cfg.package}/bin/homeserver \ + ${ lib.concatMapStringsSep "\n " (x: "--config-path ${x} \\") ([ matrix-synapse-common-config ] ++ cfg.extraConfigFiles) } + --keys-directory ${cfg.dataDir} \ + --generate-keys + ''; + environment.PYTHONPATH = lib.makeSearchPathOutput "lib" cfg.package.python.sitePackages [ pluginsEnv ]; + serviceConfig = { + Type = "notify"; + User = "matrix-synapse"; + Group = "matrix-synapse"; + WorkingDirectory = cfg.dataDir; + ExecStart = '' + ${cfg.package}/bin/homeserver \ + ${ lib.concatMapStringsSep "\n " (x: "--config-path ${x} \\") ([ matrix-synapse-common-config ] ++ cfg.extraConfigFiles) } + --keys-directory ${cfg.dataDir} + ''; + ExecReload = "${pkgs.utillinux}/bin/kill -HUP $MAINPID"; + Restart = "on-failure"; + }; + }; + }) + + ({ + systemd.services = let + workerList = lib.mapAttrsToList (name: value: lib.nameValuePair name value ) cfg.workers; + workerName = worker: worker.name; + workerSettings = worker: (worker.value.settings // {worker_name = (workerName worker);}); + workerConfig = worker: format.generate "matrix-synapse-worker-${workerName worker}-config.yaml" (workerSettings worker); + in builtins.listToAttrs (map (worker: + { + name = "matrix-synapse-worker-${workerName worker}"; + value = { + description = "Synapse Matrix Worker"; + after = [ "network.target" ]; + wantedBy = [ "multi-user.target" ]; + environment.PYTHONPATH = lib.makeSearchPathOutput "lib" cfg.package.python.sitePackages [ + pluginsEnv +# (cfg.package.python.pkgs.toPythonModule cfg.package) + ]; + serviceConfig = { + Type = "notify"; + User = "matrix-synapse"; + Group = "matrix-synapse"; + WorkingDirectory = cfg.dataDir; + ExecStart = '' + ${cfg.package.python.withPackages (ps: [(cfg.package.python.pkgs.toPythonModule cfg.package)])}/bin/python -m synapse.app.generic_worker \ + ${ lib.concatMapStringsSep "\n " (x: "--config-path ${x} \\") ([ matrix-synapse-common-config (workerConfig worker) ] ++ cfg.extraConfigFiles) } + --keys-directory ${cfg.dataDir} + ''; + }; + }; + } + ) workerList); + }) + ]); +} diff --git a/synapse-module/matrix-synapse-log_config.yaml b/synapse-module/matrix-synapse-log_config.yaml new file mode 100644 index 0000000..d85bdd1 --- /dev/null +++ b/synapse-module/matrix-synapse-log_config.yaml @@ -0,0 +1,25 @@ +version: 1 + +# In systemd's journal, loglevel is implicitly stored, so let's omit it +# from the message text. +formatters: + journal_fmt: + format: '%(name)s: [%(request)s] %(message)s' + +filters: + context: + (): synapse.util.logcontext.LoggingContextFilter + request: "" + +handlers: + journal: + class: systemd.journal.JournalHandler + formatter: journal_fmt + filters: [context] + SYSLOG_IDENTIFIER: synapse + +root: + level: INFO + handlers: [journal] + +disable_existing_loggers: False