/jitsi-meet

Permalink
Switch branches/tags
jitsi-meet_2741 jitsi-meet_2740 jitsi-meet_2739 jitsi-meet_2738 jitsi-meet_2737 jitsi-meet_2736 jitsi-meet_2735 jitsi-meet_2734 jitsi-meet_2733 jitsi-meet_2732 jitsi-meet_2731 jitsi-meet_2730 jitsi-meet_2729 jitsi-meet_2728 jitsi-meet_2727 jitsi-meet_2726 jitsi-meet_2725 jitsi-meet_2724 jitsi-meet_2723 jitsi-meet_2722 jitsi-meet_2721 jitsi-meet_2720 jitsi-meet_2719 jitsi-meet_2718 jitsi-meet_2717 jitsi-meet_2716 jitsi-meet_2715 jitsi-meet_2714 jitsi-meet_2713 jitsi-meet_2712 jitsi-meet_2711 jitsi-meet_2710 jitsi-meet_2709 jitsi-meet_2708 jitsi-meet_2707 jitsi-meet_2706 jitsi-meet_2705 jitsi-meet_2704 jitsi-meet_2703 jitsi-meet_2702 jitsi-meet_2701 jitsi-meet_2700 jitsi-meet_2699 jitsi-meet_2698 jitsi-meet_2697 jitsi-meet_2696 jitsi-meet_2695 jitsi-meet_2694 jitsi-meet_2693 jitsi-meet_2692 jitsi-meet_2691 jitsi-meet_2690 jitsi-meet_2689 jitsi-meet_2688 jitsi-meet_2687 jitsi-meet_2686 jitsi-meet_2685 jitsi-meet_2684 jitsi-meet_2683 jitsi-meet_2682 jitsi-meet_2681 jitsi-meet_2680 jitsi-meet_2679 jitsi-meet_2678 jitsi-meet_2677 jitsi-meet_2676 jitsi-meet_2675 jitsi-meet_2674 jitsi-meet_2673 jitsi-meet_2672 jitsi-meet_2671 jitsi-meet_2670 jitsi-meet_2669 jitsi-meet_2668 jitsi-meet_2667 jitsi-meet_2666 jitsi-meet_2665 jitsi-meet_2664 jitsi-meet_2663 jitsi-meet_2662 jitsi-meet_2661 jitsi-meet_2660 jitsi-meet_2659 jitsi-meet_2658 jitsi-meet_2657 jitsi-meet_2656 jitsi-meet_2655 jitsi-meet_2654 jitsi-meet_2653 jitsi-meet_2652 jitsi-meet_2651 jitsi-meet_2650 jitsi-meet_2649 jitsi-meet_2648 jitsi-meet_2647 jitsi-meet_2646 jitsi-meet_2645 jitsi-meet_2644 jitsi-meet_2643 jitsi-meet_2642
Nothing to show
Find file
jitsi-meet/doc/quick-install.md
a0a4fbf Sep 21, 2017
@turint @bgrozev @damencho @paweldomas @panagiks @marclaporte @emcho
Raw Blame History
98 lines (63 sloc) 3.98 KB

Jitsi Meet quick install

This document describes the required steps for a quick Jitsi Meet installation on a Debian based GNU/Linux system. Debian 8 (Jessie) or later, and Ubuntu 14.04 or later are supported out-of-the-box.

Debian Wheezy and other older systems may require additional things to be done. Specifically for Wheezy, libc needs to be updated.

N.B.: All commands are supposed to be run by root. If you are logged in as a regular user with sudo rights, please prepend sudo to each of the commands.

Basic Jitsi Meet install

Add the repository

echo 'deb https://download.jitsi.org stable/' >> /etc/apt/sources.list.d/jitsi-stable.list
wget -qO -  https://download.jitsi.org/jitsi-key.gpg.key | apt-key add -

Update the package lists

apt-get update

Install Jitsi Meet

Note : Something to consider before installation is how you're planning to serve Jitsi Meet. The installer will check if Nginx or Apache is present (with this order) and configure a virtualhost within the web server it finds to serve Jitsi Meet. If none of the above is found it then configures itself to be served via jetty. So if for example you are planning on deploying Jitsi Meet with a web server, you have to make sure to install the server before installing jitsi-meet.

apt-get -y install jitsi-meet

During the installation, you will be asked to enter the hostname of the Jitsi Meet instance. If you have a FQDN hostname for the instance already set up in DNS, enter it there. If you don't have a resolvable hostname, you can enter the IP address of the machine (if it is static or doesn't change).

This hostname (or IP address) will be used for virtualhost configuration inside the Jitsi Meet and also, you and your correspondents will be using it to access the web conferences.

Generate a Let's Encrypt certificate

Simply run the following in your shell

/usr/share/jitsi-meet/scripts/install-letsencrypt-cert.sh

Advanced configuration

If installation is on a machine behind NAT further configuration of jitsi-videobridge is needed in order for it to be accessible. Provided that all required ports are routed (forwarded) to the machine that it runs on. By default these ports are (TCP/443 or TCP/4443 and UDP 10000). The following extra lines need to be added the file /etc/jitsi/videobridge/sip-communicator.properties:

org.ice4j.ice.harvest.NAT_HARVESTER_LOCAL_ADDRESS=<Local.IP.Address>
org.ice4j.ice.harvest.NAT_HARVESTER_PUBLIC_ADDRESS=<Public.IP.Address>

See the documenation of ice4j for details.

Open a conference

Launch a web browser (Chrome, Chromium or latest Opera) and enter in the URL bar the hostname (or IP address) you used in the previous step.

Confirm that you trust the self-signed certificate of the newly installed Jitsi Meet.

Enjoy!

Adding sip-gateway to Jitsi Meet

Install Jigasi

apt-get -y install jigasi

or

wget https://download.jitsi.org/unstable/jigasi_1.0-107_amd64.deb
dpkg -i jigasi_1.0-107_amd64.deb

During the installation, you will be asked to enter your SIP account and password. This account will be used to invite the other SIP participants.

Reload Jitsi Meet

Launch again a browser with the Jitsi Meet URL and you'll see a telephone icon on the right end of the toolbar. Use it to invite SIP accounts to join the current conference.

Enjoy!

Uninstall

apt-get purge jigasi jitsi-meet jitsi-meet-web-config jitsi-meet-web jicofo jitsi-videobridge

Sometimes the following packages will fail to uninstall properly:

  • jigasi
  • jitsi-videobridge

When this happens, just run the uninstall command a second time and it should be ok.

The reason for failure is that sometimes, the uninstall script is faster than the process that stops the daemons. The second run of the uninstall command fixes this, as by then the jigasi or jvb daemons are already stopped.