Install Jigasi SIP Communicator
Add telephone call capabilities to your Jitsi Meet Video Conference system
By installing this next component, Jigasi, to you Jitsi installation, you can add VoIP telephone capabilities to your video call system. You can be in a video call with one or more people, and then dial out to a landline or cell phone number from within the video meeting room. You can also enable the function of people dialing in to join a meeting room (advanced users only, requires knowledge to setup Asterisk or FreePBX VoIP server).
Add Google DNS nameservers to your Jitsi Ubuntu server (instructions for Ubuntu LTS 18)
- For previous versions of Ubuntu (ie. 16), you could just edit /etc/resolv.conf and add addition nameservers for the server. You could also edit the network configuration at /etc/network/interfaces.
- However, starting with Ubuntu LTS 18, the network settings are done on YAML files that look similar to /etc/netplan/01-netcfg.yaml
|
$ sudo ls /etc/netplan $ sudo nano /etc/netplan/01-netcfg.yaml network: |
Add the items in italic starting with nameservers:
Note: the indentation matters, make sure that it looks similar to the above
Enable the changes:
| $ sudo netplan --debug apply |
If you get errors, then re-edit the YAML file and ensure that you have the indentations correct. Add a few more spaces if in doubt.
Get a SIP account credential to use with Jitsi/Jigasi:
- Sign up and create a SIP account with your favourite SIP provider. We like to use VoIP.ms
- Read: Introduction to VoIP on getting started with a SIP Subaccount
Example: VoIP.ms Subaccount
SIP Account: This email address is being protected from spambots. You need JavaScript enabled to view it.
Username: 187000_121
SIP Server: toronto9.voip.ms
Authentication ID: 187000_121 (the same as the Subaccount name)
Password: *******
Install Jigasi SIP Communicator:
|
$ sudo apt-get update $ sudo apt-get install jigasi |
When you are prompted to enter your SIP username, be sure to enter it correctly following our example.
Example SIP username: This email address is being protected from spambots. You need JavaScript enabled to view it.
When prompted for the password, be sure to enter the password correctly (you only get one try, and there is no confirmation) ********
When Jigais is finished installing, fix somethings first that don't come with the online documentation:
|
$ sudo chown jigasi /etc/jitsi/jigasi $ sudo usermod -a -G prosody admin $ sudo apt-mark hold jigasi |
Note: Replace the italicized admin with the username of your sudo user that you created and installed Ubuntu and Jitsi with
Note: Sometimes, upgrading jigasi packages may cause it to break, so the jigasi package is held back with the above command until you are sure the developer fixed his problems.
Edit the sip-communicator.properties
|
$ sudo nano /etc/jitsi/jigasi/sip-communicator.properties |
Find the parts of the file that contain the following similar segments and replace the italicized items with settings that fit your own scenario. I used ..... to shorten what is actually written in the file, and to skip several lines, for display brevity here. You need to scroll down to find the right line, or use Ctrl-W to search with a keyword.
|
.... DEFAULT_JVB_ROOM_NAME=MyClinicWaitingRoom .... .... USER_ID=187000_121 .... # Uncomment out the line below, if you are having certificate chain issues with your VoIP provider .... # Uncomment out the line below to enable SIP |
Note: Delete the server name ie. @toronto9.voip.ms at the end of the USER_ID entry that comes default.
Press Ctrl-O to Save, and Ctrl-X to Exit.
- You may also want to comment out any codecs that you don't want to use. Sometimes VoIP.ms fails because it is trying to negotiate too many codecs when connecting
- PASSWORD: If you typed in the wrong password, and need to replace it in the above properties file, you need to enter it in Base64 format. Click on this website and type in your password and click >Encode< to see that your plaintext password looks like in Base64.
Add an XMPP setting to Jicofo/sip-communicator.properties. Edit the file and add the following line below to what is already existing in the file:
|
$ sudo nano /etc/jitsi/jicofo/sip-communicator.properties ..... |
Temporarily enable Authentication to create the domain in Prosody and a first username:
- For some reason, the online instructions for installing Jitsi/Jigasi don't explain how to get Jigasi to work.
- By default, Jitsi will allow meeting room creation by anyone (anonymous users).
- You can Enable Authentication so only a Host user with a username and password can only start/activate a meeting room link.
- To get Jigasi SIP-communicator working, we will turn on authentication temporarily, in order to create a Prosody domain and username.
|
$ sudo nano /etc/prosody/conf.avail/meet.yourdomain.ca.cfg.lua ..... VirtualHost "meet.yourdomain.ca" |
Change the authentication from "anonymous" to "internal_plain".
Press Ctrl-O to Save, and Ctrl-X to Exit.
Restart all the services, and reboot the server just to ensure all the settings are loaded:
|
$ sudo service prosody restart $ sudo service jicofo restart $ sudo service jigasi restart $ sudo shutdown -r now |
Once the Jitsi server is rebooted, create a first username and password for meet.yourdomain.ca in Prosody. This will create a directory to store future usernames and passwords:
| $ sudo prosodyctl register username meet.yourdomain.ca secretpassword |
Note: you can use this opportunity to create an XMPP username "sipxmpp" and password to be later entered in to settings when you want to Enable Authentication later on.
Example: sudo prosodyctl register sipxmpp meet.yourdomain.ca ********
- A new directory will be created that looks like /var/lib/prosody/meet%2eyourdomain%2eca
- Inside that directory, you will find the username and passwords that you created for Prosody
Now go back and turn OFF authentication:
|
$ sudo nano /etc/prosody/conf.avail/meet.yourdomain.ca.cfg.lua ..... VirtualHost "meet.yourdomain.ca" |
Change "internal_plain" back to "anonymous".
Press Ctrl-O to Save, and Ctrl-X to Exit.
Then restart the services and reboot the server for good measure, again:
|
$ sudo service prosody restart $ sudo service jicofo restart $ sudo service jigasi restart $ sudo shutdown -r now |
Check to see if Jitsi and SIP communicator is working:
- Open a web browser and go to https://meet.yourdomain.ca
- You should see a blue Jitsi welcome screen. YAY!
- Start a meeting link.
- If you installed Jigasi SIP communicator correctly, you should be able to see a + sign at the bottom right icons.
- You can also check to see if Jigasi is connecting to your SIP Subaccount correctly, by loggin in to your VoIP account (ie. Voip.ms) and check to see if it the Subaccount is registering green.
- If your Subaccount is registering green (active connection), but you don't see the + sign, then there is something wrong with your Jigasi installation and settings.
- If you Subaccount is not registering (red, inactive), then it means that you typed in the wrong SIP username and password in /etc/jitsi/jigasi/sip-communicator.properties or you may not have entered the settings correctly (the USER_ID should just be the Subaccount name and NOT include the @server)
- You can also try checking your log files for errors:
- /var/log/jitsi/jigasi.log
- /var/log/jitsi/jvb.log
- /var/log/jitsi/jicofo.log
- /var/log/prosody/prosody.log
Some Location of Jitsi and Jigasi Customization:
- /usr/share/jitsi-meet/interface_config.js
- /etc/jitsi/meet/meet.yourdomain.ca-config.js
- /usr/share/jitsi-meet/libs/app.bundle.min.js
- /usr/share/jitsi-meet/title.html
- /usr/share/jitsi-meet/statis/welcomePageAdditionalContent.html
- /usr/share/jitsi-meet/favicon.ico