jiti-meet/doc/quick-install.md

77 lines
2.7 KiB
Markdown
Raw Normal View History

2014-08-01 13:54:26 +00:00
# Jitsi Meet quick install
2014-08-01 13:53:22 +00:00
2015-11-05 17:58:13 +00:00
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.
2014-08-01 13:53:22 +00:00
2015-11-05 17:58:13 +00:00
Debian Wheezy and other older systems may require additional things to be done. Specifically for Wheezy, [libc needs to be updated](http://lists.jitsi.org/pipermail/users/2015-September/010064.html).
2014-08-05 10:53:38 +00:00
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.
2014-08-01 14:02:53 +00:00
## Basic Jitsi Meet install
### Add the repository
2014-08-01 13:53:22 +00:00
```sh
2014-08-10 07:27:34 +00:00
echo 'deb http://download.jitsi.org/nightly/deb unstable/' >> /etc/apt/sources.list
2014-08-05 09:18:33 +00:00
wget -qO - https://download.jitsi.org/nightly/deb/unstable/archive.key | apt-key add -
2014-08-01 13:53:22 +00:00
```
2014-08-01 14:02:53 +00:00
### Update the package lists
2014-08-01 13:53:22 +00:00
```sh
apt-get update
```
2014-08-01 14:02:53 +00:00
### Install Jitsi Meet
2014-08-01 13:53:22 +00:00
```sh
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).
2014-08-01 13:53:22 +00:00
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.
2014-08-01 13:53:22 +00:00
2014-08-01 14:02:53 +00:00
### Open a conference
2014-08-01 13:53:22 +00:00
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.
2014-08-01 13:53:22 +00:00
Confirm that you trust the self-signed certificate of the newly installed Jitsi Meet.
Enjoy!
2014-08-01 14:01:08 +00:00
2014-08-01 14:02:53 +00:00
## Adding sip-gateway to Jitsi Meet
2014-08-01 14:01:08 +00:00
2014-08-05 10:53:38 +00:00
### Install Jigasi
2014-08-06 09:11:32 +00:00
```sh
apt-get -y install jigasi
2014-08-06 09:11:32 +00:00
```
or
2014-08-05 10:53:38 +00:00
```sh
2014-08-05 14:09:03 +00:00
wget https://download.jitsi.org/jigasi_1.0-1_amd64.deb
dpkg -i jigasi_1.0-1_amd64.deb
2014-08-05 10:53:38 +00:00
```
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.
2014-08-05 10:53:38 +00:00
### Reload Jitsi Meet
2014-08-05 11:02:30 +00:00
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.
2014-08-05 10:53:38 +00:00
Enjoy!
2014-08-05 12:55:14 +00:00
## Uninstall
2014-08-05 12:55:14 +00:00
2014-08-05 12:56:40 +00:00
```sh
apt-get purge jigasi jitsi-meet jicofo jitsi-videobridge
2014-08-05 12:56:40 +00:00
```
Sometimes the following packages will fail to uninstall properly:
2014-08-05 12:55:14 +00:00
- jigasi
- jitsi-videobridge
When this happens, just run the uninstall command a second time and it should be ok.
2014-08-05 12:55:48 +00:00
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.