Skip to content

README.md

Latest commit

 

History

History
103 lines (73 loc) · 2.45 KB

README.md

File metadata and controls

103 lines (73 loc) · 2.45 KB

Jitsi Dev Installer

jitsi-dev-installer installs a simple standalone Jitsi server for jitsi-meet developers. This script guides the user during the installation to avoid potential problems.

Supported distributions

  • Debian 12 Bookworm
  • Ubuntu 22.04 Jammy Jellyfish
  • Ubuntu 24.04 Noble Numbat

There should be at least 12 GB reserved RAM.

Usage

  • Don't run this script on a working production server.
  • Don't run this script on your desktop machine.
  • Run it on an isolated environment such as a virtual machine or a cloud server.
  • Run it as root.
  • Follow the recommendations during the installation.

use root account

If you are not already root, switch to root account. Use one of the following commands to become root according to your system:

sudo su -l

or

su -l

download installer

apt-get update
apt-get install wget

wget -T 10 -O jitsi-dev-installer https://raw.githubusercontent.com/jitsi-contrib/installers/main/jitsi-dev/jitsi-dev-installer

host addresses

For development environment, you don't need real DNS records for Jitsi and TURN domains but client machines need to be able to resolve their IP addresses. So, add them to /etc/hosts or do the equivalent depending on the client machine's OS.

These domains have to point to the IP address of Jitsi server (or virtual machine).

  • Create a local DNS A record for Jitsi that all clients can resolve.
    For example jitsi.yourdomain.com
  • Create a local DNS A record for TURN that all clients can resolve.
    For example turn.yourdomain.com
  • Jitsi address and TURN address must be different and don't use an IP as the host address
  • Set related environment variables before starting the installer
export JITSI_HOST=jitsi.yourdomain.com
export TURN_HOST=turn.yourdomain.com

run the installer

bash jitsi-dev-installer

Development

  • Login as dev user. Don't use any other account (such as root) during the development. If you log in as root then use the following command to switch to the dev account.

    su -l dev

  • The local copy of jitsi-meet repository is in /home/dev/jitsi-meet folder. Go to this folder and update the codes as you wish.

    cd jitsi-meet

# edit codes or copy your custom files into the correct places in this folder

  • Build

    npm install
make

  • Test
    Open the meeting page in your browser and test it.