jiti-meet/doc/quick-install.md

155 lines
8.4 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
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
This guide helps you ___host your own Jitsi server___. If you want to have a video conference without setting up any infrastructure, use https://meet.jit.si instead.
2014-08-01 13:53:22 +00:00
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
This document describes the required steps for a quick Jitsi Meet installation on a Debian based GNU/Linux system. Debian 9 (Stretch) or later, and Ubuntu 18.04 (Bionic Beaver) or later are supported out-of-the-box.
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
On Ubuntu systems, Jitsi requires dependencies from Ubuntu's `universe` package repository. To ensure this is enabled, run `apt-add-repository universe` at the command-line.
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
_Note_: Many of the installation steps require elevated privileges. If you are logged in using a regular user account, you may need to temporarily increase your permissions (for example, by using `sudo` for individual commands).
2014-08-05 10:53:38 +00:00
2014-08-01 14:02:53 +00:00
## Basic Jitsi Meet install
### Set up the Fully Qualified Domain Name (FQDN) (optional)
If the machine used to host the Jitsi Meet instance has a FQDN (for example `meet.example.org`) already set up in DNS, `/etc/hostname` must contain this FQDN; if this is not the case yet, [change the hostname](https://wiki.debian.org/HowTo/ChangeHostname).
Then add the same FQDN in the `/etc/hosts` file, associating it with the loopback address:
127.0.0.1 localhost meet.example.org
Finally on the same machine test that you can ping the FQDN with: `ping "$(hostname)"`-
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
### Add the Jitsi package repository
2014-08-01 13:53:22 +00:00
```sh
echo 'deb https://download.jitsi.org stable/' >> /etc/apt/sources.list.d/jitsi-stable.list
2020-04-01 20:57:08 +00:00
wget -qO - https://download.jitsi.org/jitsi-key.gpg.key | sudo apt-key add -
2014-08-01 13:53:22 +00:00
```
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
### Install Jitsi Meet
2014-08-01 13:53:22 +00:00
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
_Note_: The installer will check if [Nginx](https://nginx.org/) or [Apache](https://httpd.apache.org/) is present (in that order) and configure a virtualhost within the web server it finds to serve Jitsi Meet. If none of the above is found it then defaults to Nginx.
If you are already running Nginx on port 443 on the same machine turnserver configuration will be skipped as it will conflict with your current port 443.
2014-08-01 13:53:22 +00:00
```sh
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
# Ensure support is available for apt repositories served via HTTPS
apt-get install apt-transport-https
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
# Retrieve the latest package versions across all repositories
apt-get update
2017-07-15 13:36:06 +00:00
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
# Perform jitsi-meet installation
2014-08-01 13:53:22 +00:00
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](https://en.wikipedia.org/wiki/Fully_qualified_domain_name) 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
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
### Generate a Let's Encrypt certificate (optional, recommended)
2017-09-21 05:36:38 +00:00
In order to have encrypted communications, you need a [TLS certificate](https://en.wikipedia.org/wiki/Transport_Layer_Security). The easiest way is to use [Let's Encrypt](https://letsencrypt.org/).
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
_Note_: Jitsi Meet mobile apps *require* a valid certificate signed by a trusted [Certificate Authority](https://en.wikipedia.org/wiki/Certificate_authority) and will not be able to connect to your server if you choose a self-signed certificate.
Simply run the following in your shell:
2017-09-21 05:36:38 +00:00
```sh
/usr/share/jitsi-meet/scripts/install-letsencrypt-cert.sh
```
Note that this script uses the [HTTP-01 challenge type](https://letsencrypt.org/docs/challenge-types/) and thus your instance needs to be accessible from the public internet. If you want to use a different challenge type, don't use this script and instead choose ___I want to use my own certificate___ during jitsi-meet installation.
#### Advanced configuration
If the installation is on a machine [behind NAT](https://github.com/jitsi/jitsi-meet/blob/master/doc/faq.md) jitsi-videobridge should configure itself automatically on boot. If three way call does not work further configuration of jitsi-videobridge is needed in order for it to be accessible from outside.
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 to 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>
```
And comment the existing `org.ice4j.ice.harvest.STUN_MAPPING_HARVESTER_ADDRESSES`.
2020-03-18 09:52:09 +00:00
See [the documentation of ice4j](https://github.com/jitsi/ice4j/blob/master/doc/configuration.md)
for details.
Default deployments on systems using systemd will have low default values for maximum processes and open files. If the used bridge will expect higher number of participants the default values need to be adjusted (the default values are good for less than 100 participants).
To update the values edit `/etc/systemd/system.conf` and make sure you have the following values:
```
DefaultLimitNOFILE=65000
DefaultLimitNPROC=65000
DefaultTasksMax=65000
```
To load the values and check them look [here](#systemd-details) for details.
2020-03-18 09:52:09 +00:00
By default, anyone who has access to your jitsi instance will be able to start a conference: if your server is open to the world, anyone can have a chat with anyone else. If you want to limit the ability to start a conference to registered users, set up a "secure domain". Follow the instructions at https://github.com/jitsi/jicofo#secure-domain.
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
### Confirm that your installation is working
2014-08-01 13:53:22 +00:00
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
Launch a web browser (Chrome, Chromium or latest Opera) and enter the hostname or IP address from the previous step into the address bar.
2014-08-01 13:53:22 +00:00
If you used a self-signed certificate (as opposed to using Let's Encrypt), your web browser will ask you to confirm that you trust the certificate.
2014-08-01 13:53:22 +00:00
doc(quick install): streamline documentation (#5227) * Prioritize messaging re: using hosted Jitsi if self-hosted is not required * Update wording for self-hosting vs hosted * Expand requirements sentence into document section * Simplify Ubuntu universe step * Condense repository and package installation steps * Add comments for package installation steps * Simplify wording around hostname configuration * Simplify lets-encrypt wording * Move certificate generation step before package installation * Expand certificate instructions * Move conference test step to post-installation * Rephrase installation testing / confirmation step * Extract platform-specific installation notes * Rephrase superuser guidance * Replace lists.jitsi.org link with web.archive.org pointer * Place /etc/hosts example in code block * Remove space before colon * Add spacing before/after 'or' (improves github markdown rendering) * Revert "Add spacing before/after 'or' (improves github markdown rendering)" This reverts commit 9f33beb2ab32c17e5ef7420f1d364d5b697b1c51. * Nit: clarify apt/HTTPS relationship * Revert "Expand requirements sentence into document section" This reverts commit cf630983c0062f3efc5e546e9d00f4ea7c907dc0. * Relocate Ubuntu universe repository advice * More concise Ubuntu universe messaging * Revert "Extract platform-specific installation notes" This reverts commit 7161a700cbd7544e06759bab2c57e5f29e10273d. * Revert "Expand certificate instructions" This reverts commit 5c479e7ffb539cba73db70da67ae9fe1d56a46a6. * Revert "Move conference test step to post-installation" This reverts commit a0ee279b7caaa520acb208f8554f27a82817218b. * Revert "Simplify wording around hostname configuration" This reverts commit ceab0ab9cf3ca46dd4fce93776a8ee72b5ea2ba4. * Revert "Revert "Simplify wording around hostname configuration"" This reverts commit a7127d03dc5fb0e9098fe007389c8e67134c69f6. * Revert "Revert "Revert "Simplify wording around hostname configuration""" This reverts commit 1e5413690e10fa8b15eb3c62daf04656f986e5e1. * Revert "Remove space before colon" This reverts commit 35cae527228595ebc65a12b90d717711f24e2f05. * Mark Let's Encrypt step as optional * Mark Let's Encrypt step as recommended * Clarify Jitsi repository-add heading * Nit: remove superfluous newline * Fixup: restore Let's Encrypt descriptive text from master branch * Update supported Ubuntu version to 18.04 (LTS) * Add Ubuntu release codename * Update minimum supported Debian version to 9 (Stretch) * Undo relocation of Let's Encrypt script instructions * Add Jitsi Meet mobile app certificate requirement notice * 'Note' formatting consistency * Rephrase sudo language
2020-03-27 17:15:43 +00:00
You should see a web page prompting you to create a new meeting. Make sure that you can successfully create a meeting and that other participants are able to join the session.
If this all worked, then congratulations! You have an operational Jitsi conference service.
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
Jigasi is a server-side application acting as a gateway to Jitsi Meet conferences. It allows regular [SIP](https://en.wikipedia.org/wiki/Session_Initiation_Protocol) clients to join meetings and provides transcription capabilities.
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
wget https://download.jitsi.org/unstable/jigasi_1.0-107_amd64.deb
dpkg -i jigasi_1.0-107_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 jitsi-meet-web-config jitsi-meet-prosody jitsi-meet-turnserver jitsi-meet-web jicofo jitsi-videobridge2
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 the 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 jitsi-videobridge daemons are already stopped.
#### Systemd details
To reload the systemd changes on a running system execute `systemctl daemon-reload` and `service jitsi-videobridge2 restart`.
To check the tasks part execute `service jitsi-videobridge2 status` and you should see `Tasks: XX (limit: 65000)`.
2020-03-12 12:59:37 +00:00
To check the files and process part execute ```cat /proc/`cat /var/run/jitsi-videobridge/jitsi-videobridge.pid`/limits``` and you should see:
```
Max processes 65000 65000 processes
Max open files 65000 65000 files
```
## Debugging problems
If you run into problems, one thing to try is using a different web browser. Some versions of some browsers are known to have issues with Jitsi Meet. You can also visit https://test.webrtc.org to test your browser's [WebRTC](https://en.wikipedia.org/wiki/WebRTC) support.
Another place to look is the various log files:
```
/var/log/jitsi/jvb.log
/var/log/jitsi/jicofo.log
/var/log/prosody/prosody.log
```