# Matrix homeserver setup, using different endpoints for federation and client # traffic. The main trick for this is defining two nginx servers endpoints for # matrix.domain.com, each listening on different ports. # # Configuration inspired by : # # - https://github.com/delroth/infra.delroth.net/blob/master/roles/matrix-synapse.nix # - https://nixos.org/manual/nixos/stable/index.html#module-services-matrix # { config, lib, pkgs, ... }: let inherit (lib) mkEnableOption mkIf mkOption ; cfg = config.my.services.matrix; my = config.my; federationPort = { public = 8448; private = 11338; }; clientPort = { public = 443; private = 11339; }; domain = config.networking.domain; in { options.my.services.matrix = let inherit (lib) types; in { enable = mkEnableOption "Matrix Synapse"; secretConfigFile = mkOption { type = types.nullOr types.path; default = null; example = "/var/run/my_secrets/config.secret"; description = "Secrets file included in configuration"; }; emailConfig = mkOption { type = types.submodule { options = { smtpHost = mkOption { type = types.str; default = "localhost"; }; smtpPort = mkOption { type = types.port; default = 587; description = '' The port to use to connect to the SMTP host. Defaulting to STARTTLS port 587 because TLS port 465 isn't supported by synapse See https://github.com/matrix-org/synapse/issues/8046 ''; }; smtpUser = mkOption { type = types.str; }; smtpPass = mkOption { type = types.str; }; notifFrom = mkOption { type = types.str; example = "Your Friendly %(app)s homeserver "; }; }; }; }; }; config = mkIf cfg.enable { services.postgresql = { enable = true; }; services.postgresqlBackup = { databases = [ "matrix-synapse" ]; }; services.matrix-synapse = { enable = true; extraConfigFiles = lib.optionals (cfg.secretConfigFile != null) [ cfg.secretConfigFile ]; settings = let logConfig = '' 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: WARN handlers: [journal] disable_existing_loggers: False ''; in { server_name = domain; public_baseurl = "https://matrix.${domain}"; account_threepid_delegates = { msisdn = "https://vector.im"; }; listeners = [ # Federation { bind_addresses = [ "::1" ]; port = federationPort.private; tls = false; # Terminated by nginx. x_forwarded = true; resources = [ { names = [ "federation" ]; compress = false; } ]; } # Client { bind_addresses = [ "::1" ]; port = clientPort.private; tls = false; # Terminated by nginx. x_forwarded = true; resources = [ { names = [ "client" ]; compress = false; } ]; } ]; experimental_features = { spaces_enabled = true; }; use_presence = false; email = { smtp_host = cfg.emailConfig.smtpHost; smtp_port = cfg.emailConfig.smtpPort; smtp_user = cfg.emailConfig.smtpUser; smtp_pass = cfg.emailConfig.smtpPass; require_transport_security = true; notif_from = cfg.emailConfig.notifFrom; }; log_config = pkgs.writeText "log_config.yaml" logConfig; }; }; services.nginx = { virtualHosts = { "matrix.${domain}" = { onlySSL = true; useACMEHost = domain; locations = let proxyToClientPort = { proxyPass = "http://[::1]:${toString clientPort.private}"; }; in { # Or do a redirect instead of the 404, or whatever is appropriate # for you. But do not put a Matrix Web client here! See the # Element web section below. "/".return = "404"; "/_matrix" = proxyToClientPort; "/_synapse/client" = proxyToClientPort; }; listen = [ { addr = "0.0.0.0"; port = clientPort.public; ssl = true; } { addr = "[::]"; port = clientPort.public; ssl = true; } ]; }; # same as above, but listening on the federation port "matrix.${domain}_federation" = rec { onlySSL = true; serverName = "matrix.${domain}"; useACMEHost = domain; locations."/".return = "404"; locations."/_matrix" = { proxyPass = "http://[::1]:${toString federationPort.private}"; }; listen = [ { addr = "0.0.0.0"; port = federationPort.public; ssl = true; } { addr = "[::]"; port = federationPort.public; ssl = true; } ]; }; "${domain}" = { forceSSL = true; useACMEHost = domain; locations."= /.well-known/matrix/server".extraConfig = let server = { "m.server" = "matrix.${domain}:${toString federationPort.public}"; }; in '' add_header Content-Type application/json; return 200 '${builtins.toJSON server}'; ''; locations."= /.well-known/matrix/client".extraConfig = let client = { "m.homeserver" = { "base_url" = "https://matrix.${domain}"; }; "m.identity_server" = { "base_url" = "https://vector.im"; }; }; # ACAO required to allow element-web on any URL to request this json file in '' add_header Content-Type application/json; add_header Access-Control-Allow-Origin *; return 200 '${builtins.toJSON client}'; ''; }; # Element Web app deployment # "chat.${domain}" = { useACMEHost = domain; forceSSL = true; root = pkgs.element-web.override { conf = { default_server_config = { "m.homeserver" = { "base_url" = "https://matrix.${domain}"; "server_name" = "${domain}"; }; "m.identity_server" = { "base_url" = "https://vector.im"; }; }; showLabsSettings = true; defaultCountryCode = "FR"; # cocorico roomDirectory = { "servers" = [ "matrix.org" "mozilla.org" "prologin.org" ]; }; }; }; }; }; }; # For administration tools. environment.systemPackages = [ pkgs.matrix-synapse ]; networking.firewall.allowedTCPPorts = [ clientPort.public federationPort.public ]; my.services.restic-backup = let dataDir = config.services.matrix-synapse.dataDir; in mkIf cfg.enable { paths = [ dataDir ]; # this is just caching for other servers media, doesn't need backup exclude = [ "${dataDir}/media/remote_*" ]; }; }; }