# Jitsi Meet Video Conferencing

> Self-hosted video conferencing with Jitsi Meet, Jibri recording, and Jigasi.

- Category: Message Queues & Brokers
- Difficulty: advanced
- Components: jitsi-web, jicofo, jvb, jibri, prosody
- Tags: jitsi, video, conferencing, webrtc, recording
- Source: https://docker.recipes/messaging/jitsi-meet-complete

## Overview

Jitsi Meet is an open-source video conferencing platform that provides secure, browser-based communication without requiring user registration or software downloads. Originally developed by Emil Ivov and later acquired by 8x8, Jitsi has become a leading alternative to commercial video conferencing solutions, offering end-to-end encryption and complete control over data privacy. The platform leverages WebRTC technology to deliver high-quality audio and video directly through web browsers, making it accessible across all major operating systems and devices.

This comprehensive Jitsi stack combines five essential components that work together to create a complete video conferencing infrastructure. The jitsi-web container serves the web interface and client application, while Prosody acts as the XMPP server handling user authentication and messaging. Jicofo (JItsi COnference FOcus) manages conference sessions and participant coordination, JVB (Jitsi Videobridge) handles the actual media routing and streaming, and Jibri provides recording and live streaming capabilities to external platforms like YouTube or file storage.

This deployment is ideal for organizations requiring complete control over their video conferencing infrastructure, including educational institutions conducting remote learning, healthcare providers needing HIPAA-compliant communication, and enterprises with strict data sovereignty requirements. The inclusion of Jibri recording capabilities makes it particularly valuable for businesses needing to archive meetings for compliance or training purposes, while the Prosody XMPP server enables custom authentication integration with existing enterprise systems.

## Features

- WebRTC-based peer-to-peer video conferencing with automatic quality adaptation based on network conditions
- Jibri integration for recording meetings to local storage and live streaming to YouTube, Facebook, or custom RTMP endpoints
- Prosody XMPP server with internal authentication and support for LDAP, JWT, and SAML integration
- JVB media routing with support for simulcast, VP8/VP9 video codecs, and Opus audio encoding
- Jicofo conference management with automatic load balancing across multiple JVB instances
- Built-in screen sharing, chat messaging, and whiteboard collaboration tools
- End-to-end encryption support with configurable security policies and lobby mode
- REST API access for programmatic room creation, participant management, and recording control

## Use cases

- Enterprise video conferencing with meeting recording for compliance and training documentation
- Educational institutions hosting virtual classrooms with lecture recording and screen sharing capabilities
- Healthcare organizations requiring HIPAA-compliant video consultations with encrypted communication
- Government agencies needing self-hosted communication platforms with complete data sovereignty control
- Software development teams conducting daily standups, code reviews, and sprint planning meetings
- Event organizers hosting virtual conferences with live streaming to social media platforms
- Customer support teams providing face-to-face technical assistance with screen sharing functionality

## Prerequisites

- Minimum 4GB RAM and 2 CPU cores for basic deployment, 8GB+ for recording with Jibri
- UDP port 10000 open on firewall for JVB media traffic and TCP ports 80/443 for web access
- Valid SSL certificate for production deployment (Let's Encrypt integration available)
- TURN server configuration for participants behind restrictive NATs or corporate firewalls
- Docker host with sufficient /dev/shm space (2GB+) for Jibri Chrome browser instances
- Domain name with proper DNS A records pointing to your server's public IP address

## docker-compose.yml

```yaml
services:
  web:
    image: jitsi/web:latest
    ports:
      - "8443:443"
      - "8080:80"
    environment:
      - ENABLE_LETSENCRYPT=0
      - PUBLIC_URL=https://localhost:8443
      - TZ=UTC
    volumes:
      - ./web:/config
      - ./transcripts:/usr/share/jitsi-meet/transcripts
    networks:
      jitsi:
        aliases:
          - meet.jitsi

  prosody:
    image: jitsi/prosody:latest
    environment:
      - ENABLE_AUTH=1
      - AUTH_TYPE=internal
      - JICOFO_AUTH_PASSWORD=${JICOFO_PASSWORD}
      - JVB_AUTH_PASSWORD=${JVB_PASSWORD}
      - JIBRI_RECORDER_PASSWORD=${JIBRI_PASSWORD}
    volumes:
      - ./prosody/config:/config
      - ./prosody/prosody-plugins-custom:/prosody-plugins-custom
    networks:
      jitsi:
        aliases:
          - xmpp.meet.jitsi

  jicofo:
    image: jitsi/jicofo:latest
    environment:
      - JICOFO_AUTH_PASSWORD=${JICOFO_PASSWORD}
      - TZ=UTC
    volumes:
      - ./jicofo:/config
    depends_on:
      - prosody
    networks:
      - jitsi

  jvb:
    image: jitsi/jvb:latest
    ports:
      - "10000:10000/udp"
    environment:
      - JVB_AUTH_PASSWORD=${JVB_PASSWORD}
      - JVB_PORT=10000
      - JVB_TCP_PORT=4443
      - TZ=UTC
    volumes:
      - ./jvb:/config
    depends_on:
      - prosody
    networks:
      - jitsi

  jibri:
    image: jitsi/jibri:latest
    cap_add:
      - SYS_ADMIN
    environment:
      - JIBRI_RECORDER_PASSWORD=${JIBRI_PASSWORD}
      - DISPLAY=:0
    volumes:
      - ./jibri:/config
      - /dev/shm:/dev/shm
      - ./recordings:/recordings
    depends_on:
      - jicofo
    networks:
      - jitsi

volumes:
  web:
  prosody:
  jicofo:
  jvb:
  jibri:

networks:
  jitsi:
```

## .env

```bash
# Jitsi Meet
JICOFO_PASSWORD=secure_jicofo_password
JVB_PASSWORD=secure_jvb_password
JIBRI_PASSWORD=secure_jibri_password

# Jitsi at https://localhost:8443
# UDP 10000 for video bridge
```

## Usage notes

- Jitsi at https://localhost:8443
- Jibri for recording/streaming
- UDP port 10000 required for video
- Configure TURN server for NAT
- Internal auth by default

## Troubleshooting

- Participants can't join meetings: Verify UDP port 10000 is open and accessible from external networks
- Jibri recording fails with Chrome crashes: Increase /dev/shm size to at least 2GB and ensure SYS_ADMIN capability
- Audio/video quality issues: Configure TURN server settings and check bandwidth between JVB and participants
- Prosody authentication errors: Verify JICOFO_PASSWORD and JVB_PASSWORD match across all service configurations
- Web interface shows 'connection failed': Check that prosody container is healthy and XMPP domain resolution works
- Recordings have no audio: Ensure PulseAudio is properly configured in Jibri container and ALSA devices are accessible

