# Jitsi Meet Video Conferencing

> Self-hosted video conferencing with Jitsi Meet, Jicofo, JVB, and Prosody XMPP.

- Category: Productivity & Collaboration
- Difficulty: advanced
- Components: jitsi-web, jicofo, jvb, prosody
- Tags: jitsi, video, conferencing, webrtc, xmpp
- Source: https://docker.recipes/productivity/jitsi-meet-stack

## Overview

Jitsi Meet is an open-source video conferencing solution that enables secure, high-quality virtual meetings without requiring user registration or software downloads. Originally developed by Jitsi and now maintained by 8x8, it provides a complete WebRTC-based communication platform that can be self-hosted for full privacy control. The stack consists of four essential components: jitsi-web serves the browser-based meeting interface, Prosody handles XMPP messaging and authentication, Jicofo (Jitsi Conference Focus) manages conference sessions and participant coordination, and JVB (Jitsi Videobridge) routes media streams efficiently between participants.

This multi-container deployment creates a production-grade video conferencing infrastructure that rivals commercial solutions like Zoom or Teams. The architecture separates concerns effectively - the web frontend handles user interactions, Prosody manages secure messaging protocols, Jicofo orchestrates meeting logistics, and JVB optimizes bandwidth usage through selective forwarding unit technology. Unlike traditional conferencing systems that route all media through central servers, JVB intelligently forwards only necessary streams to each participant, dramatically reducing server load and improving call quality.

Organizations seeking complete control over their communication infrastructure will find this stack invaluable, particularly those in healthcare, government, or finance where data sovereignty is critical. Educational institutions benefit from unlimited meeting duration and participant counts, while development teams appreciate the ability to customize features and integrate with existing authentication systems. The combination eliminates recurring subscription costs while providing enterprise-grade features like recording, screen sharing, and mobile compatibility.

## Features

- WebRTC-based real-time communication with automatic codec negotiation and adaptive bitrate streaming
- Prosody XMPP server integration for secure messaging, presence, and multi-user chat functionality
- Jicofo conference orchestration with automatic participant load balancing and session management
- JVB selective forwarding unit technology that reduces bandwidth usage by up to 90% compared to traditional MCUs
- Built-in screen sharing, virtual backgrounds, and recording capabilities without third-party plugins
- Guest access support allowing anonymous users to join meetings without account creation
- JWT authentication integration for enterprise single sign-on and user management systems
- Multi-language interface support with real-time transcription and closed captioning features

## Use cases

- Enterprise organizations replacing Zoom or Teams with self-hosted infrastructure for complete data control
- Healthcare providers conducting HIPAA-compliant telemedicine consultations with encrypted communications
- Educational institutions hosting unlimited-duration classes and webinars without per-user licensing costs
- Government agencies requiring air-gapped video conferencing solutions for classified or sensitive meetings
- Open source communities hosting public meetings and conferences with customizable branding and features
- Development teams integrating video calling capabilities into custom applications via Jitsi's APIs
- Remote teams in privacy-conscious organizations avoiding data sharing with commercial conferencing providers

## Prerequisites

- Minimum 4GB RAM and 2 CPU cores for small deployments (up to 20 participants simultaneously)
- Port 10000/UDP open for JVB media traffic and port 8080/8443 for web interface access
- Valid SSL certificate and domain name configured for PUBLIC_URL environment variable
- Generated authentication passwords using openssl rand -hex 16 for JICOFO_AUTH_PASSWORD and JVB_AUTH_PASSWORD
- Understanding of XMPP protocols and WebRTC networking for advanced configuration and troubleshooting
- Firewall configuration allowing UDP traffic on port 10000 and TCP traffic on configured web ports

## docker-compose.yml

```yaml
services:
  web:
    image: jitsi/web:latest
    ports:
      - "8080:80"
      - "8443:443"
    volumes:
      - web_config:/config:Z
      - web_crontabs:/var/spool/cron/crontabs:Z
      - web_transcripts:/usr/share/jitsi-meet/transcripts:Z
    environment:
      ENABLE_AUTH: ${ENABLE_AUTH}
      ENABLE_GUESTS: ${ENABLE_GUESTS}
      ENABLE_TRANSCRIPTIONS: ${ENABLE_TRANSCRIPTIONS}
      PUBLIC_URL: ${PUBLIC_URL}
      TZ: ${TZ}
    networks:
      meet.jitsi:

  prosody:
    image: jitsi/prosody:latest
    volumes:
      - prosody_config:/config:Z
      - prosody_plugins:/prosody-plugins-custom:Z
    environment:
      AUTH_TYPE: ${AUTH_TYPE}
      ENABLE_AUTH: ${ENABLE_AUTH}
      ENABLE_GUESTS: ${ENABLE_GUESTS}
      PUBLIC_URL: ${PUBLIC_URL}
      TZ: ${TZ}
    networks:
      meet.jitsi:
        aliases:
          - xmpp.meet.jitsi

  jicofo:
    image: jitsi/jicofo:latest
    volumes:
      - jicofo_config:/config:Z
    environment:
      AUTH_TYPE: ${AUTH_TYPE}
      TZ: ${TZ}
      JICOFO_AUTH_PASSWORD: ${JICOFO_AUTH_PASSWORD}
    depends_on:
      - prosody
    networks:
      meet.jitsi:

  jvb:
    image: jitsi/jvb:latest
    ports:
      - "10000:10000/udp"
      - "4443:4443"
    volumes:
      - jvb_config:/config:Z
    environment:
      PUBLIC_URL: ${PUBLIC_URL}
      TZ: ${TZ}
      JVB_AUTH_PASSWORD: ${JVB_AUTH_PASSWORD}
      JVB_PORT: 10000
      JVB_STUN_SERVERS: stun.l.google.com:19302,stun1.l.google.com:19302
    depends_on:
      - prosody
    networks:
      meet.jitsi:

volumes:
  web_config:
  web_crontabs:
  web_transcripts:
  prosody_config:
  prosody_plugins:
  jicofo_config:
  jvb_config:

networks:
  meet.jitsi:
    driver: bridge
```

## .env

```bash
# Public URL
PUBLIC_URL=https://meet.example.com

# Authentication
ENABLE_AUTH=1
ENABLE_GUESTS=1
AUTH_TYPE=internal

# Component Passwords (generate with: openssl rand -hex 16)
JICOFO_AUTH_PASSWORD=your_jicofo_password
JVB_AUTH_PASSWORD=your_jvb_password

# Timezone
TZ=UTC

# Optional Features
ENABLE_TRANSCRIPTIONS=0
```

## Usage notes

- Jitsi Meet at https://meet.example.com
- Port 10000/UDP required for video
- Generate passwords with openssl rand -hex 16
- Use Jitsi official docker-compose for production

## Troubleshooting

- Participants cannot join meetings or see black screens: Verify JVB_STUN_SERVERS are accessible and port 10000/UDP is properly forwarded through firewalls and NAT
- Authentication failures between Jicofo and Prosody: Ensure JICOFO_AUTH_PASSWORD matches across containers and Prosody has fully initialized before Jicofo starts
- Audio/video quality issues or frequent disconnections: Check JVB memory allocation and increase container resources, verify network stability between JVB and participants
- Web interface loads but meetings fail to start: Confirm PUBLIC_URL matches your actual domain and SSL certificates are valid for the configured hostname
- XMPP connection errors in Prosody logs: Verify prosody container has proper DNS resolution for xmpp.meet.jitsi alias and authentication credentials are correctly configured
- Recording or transcription features not working: Check web_transcripts volume permissions and ensure ENABLE_TRANSCRIPTIONS is set to 1 in environment variables

