/jitsi-helm

A helm chart to deploy Jitsi to Kubernetes

Primary LanguageMustacheMIT LicenseMIT

Helm Chart for Jitsi Meet

jitsi-meet Secure, Simple and Scalable Video Conferences that you use as a standalone app or embed in your web application.

TL;DR;

helm repo add jitsi https://jitsi-contrib.github.io/jitsi-helm/
helm install myjitsi jitsi/jitsi-meet

Introduction

This chart bootstraps a jitsi-meet deployment, like the official one.

Different topology

To be able to do video conferencing with other people, the jvb component should be reachable by all participants (eg: a public IP). Thus the default behaviour of advertised the internal IP of jvb, is not really suitable in many cases. Kubernetes offers multiple possibilities to work around the problem. Not all options are available depending on the Kubernetes cluster setup. The chart tries to make all options available without enforcing one.

Option 1: service of type LoadBalancer

This requires a cloud setup that enables a Loadbalancer attachement. This could be enabled via values:

jvb:
  service:
    type: LoadBalancer

  # Depending on the cloud, LB's public IP cannot be known in advance, so deploy first, without the next option.
  # Next: redeploy with the following option set to the public IP you retrieved from the API.
  # Additionally, you can add your cluster's public IPs if you want to use direct connection as a fallback.
  publicIPs:
    - 1.2.3.4
    # - 30.10.10.1
    # - 30.10.10.2

In this case you're not allowed to change the jvb.replicaCount to more than 1, UDP packets will be routed to random jvb, which would not allow for a working video setup.

Option 2: NodePort and node with Public IP or external loadbalancer

jvb:
  service:
    type: NodePort
  # Set the following variable if you want to use a specific external port for the service.
  # The default is to select a random port from Kubelet's allowed NodePort range (30000-32767).

  # nodePort: 10000

  # Use public IP of one (or more) of your nodes,
  # or the public IP of an external LB:
  publicIPs:
    - 30.10.10.1

In this case you're not allowed to change the jvb.replicaCount to more than 1, UDP packets will be routed to random jvb, which would not allow for a working video setup.

Option 3: hostPort and node with Public IP

jvb:
  useHostPort: true
  # Use public IP of one (or more) of your nodes,
  # or the public IP of an external LB:
  publicIPs:
    - 30.10.10.1

In this case you can have more the one jvb but you're putting you cluster at risk by having it directly exposed on the Internet.

Option 4: hostNetwork

jvb:
  useHostNetwork: true

Similar to Option 3, this way you expose JVB "as is" on the node, without any additional protection. This is not recommended, but might be useful in some rare cases.

Option 4: Use ingress TCP/UDP forward capabilities

In case of an ingress capable of doing tcp/udp forwarding (like nginx-ingress), it can be setup to forward the video streams.

# Don't forget to configure the ingress properly (separate configuration)
jvb:
  # 1.2.3.4 being one of the IP of the ingress controller
  publicIPs:
    - 1.2.3.4

Again in this case, only one jvb will work in this case.

Option 5: Bring your own setup

There are multiple other possibilities combining the available parameters, depending of your cluster/network setup.

Recording and streaming support

This chart includes support for Jibri, which allows Jitsi Meet users to record and stream their meetings. To enable Jibri support, add this section to your values.yaml:

jibri:
  ## Enabling Jibri will allow users to record
  ## and/or stream their meetings (e.g. to YouTube).
  enabled: true

  ## Enable single-use mode for Jibri (recommended).
  singleUseMode: false

  ## Enable multiple Jibri instances.
  ## Secommended for single-use mode.
  replicaCount: 1

  ## Enable recording service.
  ## Set this to true/false to enable/disable local recordings.
  ## Defaults to enabled (allow local recordings).
  recording: true

  ## Enable livestreaming service.
  ## Set this to true/false to enable/disable live streams.
  ## Defaults to disabled (livestreaming is forbidden).
  livestreaming: true

  ## Enable persistent storage for local recordings.
  ## If disabled, jibri pod will use a transient
  ## emptyDir-backed storage instead.
  persistence:
    enabled: true
    size: 32Gi

  shm:
    ## Set to true to enable "/dev/shm" mount.
    ## May be required by built-in Chromium.
    enabled: true


## Required to allow Jibri to connect to Jitsi Meet service:
prosody:
  extraEnvFrom:
    <...>
  ## Uncomment this if you want to use jibri:
  - secretRef:
      name: '{{ include "prosody.fullname" . }}-jibri'

The above example will allow your Jitsi users to make local recordings, as well as live streams of their meetings.

Configuration

The following table lists the configurable parameters of the jisti-meet chart and their default values.

Parameter Description Default
imagePullSecrets List of names of secrets resources containing private registry credentials []
enableAuth Enable authentication false
enableGuests Enable guest access true
websockets.colibri.enabled Enable WebSocket support for JVB/Colibri false
websockets.xmpp.enabled Enable WebSocket support for Prosody/XMPP false
jibri.enabled Enable Jibri service false
jibri.useExternalJibri Use external Jibri service, instead of chart-provided one false
jibri.singleUseMode Enable Jibri single-use mode false
jibri.recording Enable local recording service true
jibri.livestreaming Enable livestreaming service false
jibri.persistence.enabled Enable persistent storage for Jibri recordings false
jibri.persistence.size Jibri persistent storage size 4Gi
jibri.persistence.existingClaim Use pre-created PVC for Jibri (unset)
jibri.persistence.storageClassName StorageClass to use with Jibri (unset)
jibri.shm.enabled Allocate shared memory to Jibri pod false
jibri.shm.useHost Pass /dev/shm from host to Jibri false
jibri.shm.size Jibri shared memory size 256Mi
jibri.replicaCount Number of replica of the jibri pods 1
jibri.image.repository Name of the image to use for the jibri pods jitsi/jibri
jibri.extraEnvs Map containing additional environment variables for jibri '{}'
jibri.livenessProbe Map that holds the liveness probe, you can add parameters such as timeout or retries following the Kubernetes spec A livenessProbe map
jibri.readinessProbe Map that holds the readiness probe, you can add parameters such as timeout or retries following the Kubernetes spec A readinessProbe map
jibri.breweryMuc Name of the XMPP MUC used by jibri jibribrewery
jibri.xmpp.user Name of the XMPP user used by jibri to authenticate jibri
jibri.xmpp.password Password used by jibri to authenticate on the XMPP service 10 random chars
jibri.recorder.user Name of the XMPP user used by jibri to record recorder
jibri.recorder.password Password used by jibri to record on the XMPP service 10 random chars
jibri.strategy Depolyment update strategy and parameters (unset)
jigasi.enabled Enable Jigasi service false
jigasi.useExternalJigasi Use external Jigasi service, instead of chart-provided one false
jigasi.replicaCount Number of replica of the Jigasi pods 1
jigasi.image.repository Name of the image to use for the Jigasi pods jitsi/jigasi
jigasi.breweryMuc Name of the XMPP MUC used by Jigasi jigasibrewery
jigasi.xmpp.user Name of the XMPP user used by Jigasi to authenticate jigasi
jigasi.xmpp.password Password used by Jigasi to authenticate on the XMPP service 10 random chars
jigasi.livenessProbe Map that holds the liveness probe, you can add parameters such as timeout or retries following the Kubernetes spec A livenessProbe map
jigasi.readinessProbe Map that holds the readiness probe, you can add parameters such as timeout or retries following the Kubernetes spec A readinessProbe map
jigasi.extraEnvs Map containing additional environment variables for Jigasi '{}'
jicofo.replicaCount Number of replica of the jicofo pods 1
jicofo.image.repository Name of the image to use for the jicofo pods jitsi/jicofo
jicofo.extraEnvs Map containing additional environment variables for jicofo '{}'
jicofo.livenessProbe Map that holds the liveness probe, you can add parameters such as timeout or retries following the Kubernetes spec A livenessProbe map
jicofo.readinessProbe Map that holds the readiness probe, you can add parameters such as timeout or retries following the Kubernetes spec A readinessProbe map
jicofo.xmpp.password Password used by jicofo to authenticate on the XMPP service 10 random chars
jicofo.xmpp.componentSecret Values of the secret used by jicofo for the xmpp-component 10 random chars
jvb.publicIPs List of IP addresses for JVB to announce to clients (unset)
jvb.service.enabled Boolean to enable os disable the jvb service creation false if jvb.useHostPort is true otherwise true
jvb.service.type Type of the jvb service ClusterIP
jvb.UDPPort UDP port used by jvb, also affects port of service, and hostPort 10000
jvb.nodePort UDP port used by NodePort service (unset)
jvb.useHostPort Enable HostPort feature (may not work on some CNI plugins) false
jvb.useHostNetwork Connect JVB pod to host network namespace false
jvb.extraEnvs Map containing additional environment variables to jvb '{}'
jvb.xmpp.user Name of the XMPP user used by jvb to authenticate jvb
jvb.xmpp.password Password used by jvb to authenticate on the XMPP service 10 random chars
jvb.livenessProbe Map that holds the liveness probe, you can add parameters such as timeout or retries following the Kubernetes spec A livenessProbe map
jvb.readinessProbe Map that holds the readiness probe, you can add parameters such as timeout or retries following the Kubernetes spec A readinessProbe map
jvb.metrics.enabled Boolean that control the metrics exporter for jvb. If true the ServiceMonitor will also created false
jvb.metrics.prometheusAnnotations Boolean that controls the generation of prometheus annotations, to expose metrics for HPA false
jvb.metrics.image.repository Default image repository for metrics exporter docker.io/systemli/prometheus-jitsi-meet-exporter
jvb.metrics.image.tag Default tag for metrics exporter 1.1.5
jvb.metrics.image.pullPolicy ImagePullPolicy for metrics exporter IfNotPresent
jvb.metrics.serviceMonitor.enabled ServiceMonitor for Prometheus true
jvb.metrics.serviceMonitor.selector Selector for ServiceMonitor { release: prometheus-operator }
jvb.metrics.serviceMonitor.interval Interval for ServiceMonitor 10s
jvb.metrics.serviceMonitor.honorLabels Make ServiceMonitor honor labels false
jvb.metrics.resources Resources for the metrics container { requests: { cpu: 10m, memory: 16Mi }, limits: { cpu: 20m, memory: 32Mi } }
octo.enabled Boolean to enable or disable the OCTO mode, for a single region false
web.httpsEnabled Boolean that enabled tls-termination on the web pods. Useful if you expose the UI via a Loadbalancer IP instead of an ingress false
web.httpRedirect Boolean that enabled http-to-https redirection. Useful for ingress that don't support this feature (ex: GKE ingress) false
web.resolverIP Override nameserver IP for Web container (unset, use auto-detected nameserver IP)
web.extraEnvs Map containing additional environment variable to web pods '{}'
web.livenessProbe Map that holds the liveness probe, you can add parameters such as timeout or retries following the Kubernetes spec A livenessProbe map
web.readinessProbe Map that holds the readiness probe, you can add parameters such as timeout or retries following the Kubernetes spec A readinessProbe map
tz System Time Zone Europe/Amsterdam

Package

helm package . -d docs
helm repo index docs --url https://jitsi-contrib.github.io/jitsi-helm/