Matrix: Difference between revisions
imported>Frederictobiasc m Fix path to `app_service_config_files` |
m Fix deprecation of three options |
||
| (8 intermediate revisions by 7 users not shown) | |||
| Line 1: | Line 1: | ||
[https://matrix.org Matrix] defines a set of open APIs for decentralised communication, suitable for securely publishing, persisting and subscribing to data over a global open federation of servers with no single point of control. Uses include Instant Messaging (IM), Voice over IP (VoIP) signalling, Internet of Things (IoT) communication, and bridging together existing communication silos - providing the basis of a new open real-time communication ecosystem. | [https://matrix.org Matrix] defines a set of open APIs for decentralised communication, suitable for securely publishing, persisting and subscribing to data over a global open federation of servers with no single point of control. Uses include Instant Messaging (IM), Voice over IP (VoIP) signalling, Internet of Things (IoT) communication, and bridging together existing communication silos - providing the basis of a new open real-time communication ecosystem. | ||
This article extends the documentation in [https://nixos.org/manual/nixos/stable/#module-services-matrix NixOS manual]. | |||
== NixOS Matrix channels == | == NixOS Matrix channels == | ||
| Line 18: | Line 20: | ||
* [https://search.nixos.org/packages?query=fractal Fractal] | * [https://search.nixos.org/packages?query=fractal Fractal] | ||
* [https://search.nixos.org/packages?query=gomuks gomuks] | * [https://search.nixos.org/packages?query=gomuks gomuks] | ||
* [https://search.nixos.org/packages?query= | * [https://search.nixos.org/packages?query=neochat neochat] | ||
* [https://search.nixos.org/packages?query=mirage-im Mirage] | * [https://search.nixos.org/packages?query=mirage-im Mirage] | ||
* [https://search.nixos.org/packages?query=nheko nheko] | * [https://search.nixos.org/packages?query=nheko nheko] | ||
* [https://search.nixos.org/packages?query=quaternion Quaternion] | * [https://search.nixos.org/packages?query=quaternion Quaternion] | ||
* [https://search.nixos.org/packages?query=iamb iamb] | |||
A [https://search.nixos.org/packages?query=purple-matrix Pidgin / libpurple plugin] is also available. | A [https://search.nixos.org/packages?query=purple-matrix Pidgin / libpurple plugin] is also available. | ||
==== Element ==== | |||
The [https://github.com/vector-im/element-web/blob/develop/config.sample.json config.json] file used by Element can be configured as such: | |||
<syntaxhighlight lang="nix"> | |||
nixpkgs.config.element-web.conf = { | |||
show_labs_settings = true; | |||
default_theme = "dark"; | |||
}; | |||
</syntaxhighlight> | |||
=== Web clients === | === Web clients === | ||
| Line 86: | Line 100: | ||
networking.firewall = { | networking.firewall = { | ||
interfaces.enp2s0 = let | interfaces.enp2s0 = let | ||
range = with config.services.coturn; | range = with config.services.coturn; lib.singleton { | ||
from = min-port; | |||
to = max-port; | |||
}; | |||
in | in | ||
{ | { | ||
| Line 105: | Line 119: | ||
}; | }; | ||
# configure synapse to point users to coturn | # configure synapse to point users to coturn | ||
services.matrix-synapse = with config.services.coturn; { | services.matrix-synapse.settings = with config.services.coturn; { | ||
turn_uris = ["turn:${realm}:3478?transport=udp" "turn:${realm}:3478?transport=tcp"]; | turn_uris = ["turn:${realm}:3478?transport=udp" "turn:${realm}:3478?transport=tcp"]; | ||
turn_shared_secret = static-auth-secret; | turn_shared_secret = static-auth-secret; | ||
| Line 118: | Line 132: | ||
=== Application services (a.k.a. bridges) === | === Application services (a.k.a. bridges) === | ||
Bridges allow you to connect Matrix to a third-party platform (like Discord, Telegram, etc.), and interact seamlessly. See [https://matrix.org/ecosystem/bridges/ here] for a list of currently supported bridges. | |||
==== mautrix-telegram ==== | ==== mautrix-telegram ==== | ||
| Line 204: | Line 220: | ||
Packaged as [https://search.nixos.org/packages?query=mautrix-whatsapp mautrix-whatsapp]. | Packaged as [https://search.nixos.org/packages?query=mautrix-whatsapp mautrix-whatsapp]. | ||
[https://github.com/NixOS/nixpkgs/pull/ | Module implemented in this [https://github.com/NixOS/nixpkgs/pull/246842 PR]. | ||
==== matrix-appservice-irc ==== | ==== matrix-appservice-irc ==== | ||
| Line 312: | Line 328: | ||
== See also == | == See also == | ||
* [[Mjolnir]] - a Matrix moderation tool | |||
* [ | |||
* [https://matrix.to/#/!vxTmkuJzhGPsMdkAOc:transformierende-gesellschaft.org?via=transformierende-gesellschaft.org The Nix Matrix Subsystem chat room, on Matrix] | * [https://matrix.to/#/!vxTmkuJzhGPsMdkAOc:transformierende-gesellschaft.org?via=transformierende-gesellschaft.org The Nix Matrix Subsystem chat room, on Matrix] | ||
[[Category:Applications]] | [[Category:Applications]] | ||
[[Category:Server]] | |||
[[Category:NixOS Manual]] | |||