dput-ng: fix eval (#364540)
[NixPkgs.git] / nixos / modules / services / web-apps / jitsi-meet.md
blob705cf69274ca3a08a0d0441039566433fc66ba41
1 # Jitsi Meet {#module-services-jitsi-meet}
3 With Jitsi Meet on NixOS you can quickly configure a complete,
4 private, self-hosted video conferencing solution.
6 ## Basic usage {#module-services-jitsi-basic-usage}
8 A minimal configuration using Let's Encrypt for TLS certificates looks like this:
9 ```nix
11   services.jitsi-meet = {
12     enable = true;
13     hostName = "jitsi.example.com";
14   };
15   services.jitsi-videobridge.openFirewall = true;
16   networking.firewall.allowedTCPPorts = [ 80 443 ];
17   security.acme.email = "me@example.com";
18   security.acme.acceptTerms = true;
20 ```
22 Jitsi Meet depends on the Prosody XMPP server only for message passing from
23 the web browser while the default Prosody configuration is intended for use
24 with standalone XMPP clients and XMPP federation. If you only use Prosody as
25 a backend for Jitsi Meet it is therefore recommended to also enable
26 {option}`services.jitsi-meet.prosody.lockdown` option to disable unnecessary
27 Prosody features such as federation or the file proxy.
29 ## Configuration {#module-services-jitsi-configuration}
31 Here is the minimal configuration with additional configurations:
32 ```nix
34   services.jitsi-meet = {
35     enable = true;
36     hostName = "jitsi.example.com";
37     prosody.lockdown = true;
38     config = {
39       enableWelcomePage = false;
40       prejoinPageEnabled = true;
41       defaultLang = "fi";
42     };
43     interfaceConfig = {
44       SHOW_JITSI_WATERMARK = false;
45       SHOW_WATERMARK_FOR_GUESTS = false;
46     };
47   };
48   services.jitsi-videobridge.openFirewall = true;
49   networking.firewall.allowedTCPPorts = [ 80 443 ];
50   security.acme.email = "me@example.com";
51   security.acme.acceptTerms = true;
53 ```