CINXE.COM
<!doctype html> <html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-2.7 docs-doc-page docs-doc-id-administration/install" data-has-hydrated="false"> <head> <meta charset="UTF-8"> <meta name="generator" content="Docusaurus v3.3.2"> <title data-rh="true">Install BigBlueButton | BigBlueButton</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.bigbluebutton.org/administration/install/"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="2.7"><meta data-rh="true" name="docusaurus_tag" content="docs-default-2.7"><meta data-rh="true" name="docsearch:version" content="2.7"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-2.7"><meta data-rh="true" property="og:title" content="Install BigBlueButton | BigBlueButton"><meta data-rh="true" name="description" content="Install BigBlueButton"><meta data-rh="true" property="og:description" content="Install BigBlueButton"><meta data-rh="true" name="keywords" content="install"><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.bigbluebutton.org/administration/install/"><link data-rh="true" rel="alternate" href="https://docs.bigbluebutton.org/administration/install/" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.bigbluebutton.org/administration/install/" hreflang="x-default"><script src="https://cdn.baycloud.com/cl.js?cid=9be233bfe3004dc49e742fd0fa98642c&hN=docs.bigbluebutton.org"></script><link rel="stylesheet" href="/assets/css/styles.47ff481a.css"> <script src="/assets/js/runtime~main.a27947b6.js" defer="defer"></script> <script src="/assets/js/main.4ea221b9.js" defer="defer"></script> </head> <body class="navigation-with-keyboard"> <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return localStorage.getItem("theme")}catch(t){}}();t(null!==e?e:"light")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/logo.svg" alt="BigBlueButton Logo" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/logo.svg" alt="BigBlueButton Logo" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div><b class="navbar__title text--truncate">BigBlueButton</b></a><a href="https://bigbluebutton.org/teachers/tutorials/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Teaching</a><a class="navbar__item navbar__link" href="/development/guide/">Development</a><a aria-current="page" class="navbar__item navbar__link navbar__link--active" href="/administration/install/">Administration</a><a class="navbar__item navbar__link" href="/greenlight/v3/install/">Greenlight</a><a class="navbar__item navbar__link" href="/new-features/">New Features</a><a class="navbar__item navbar__link" href="/support/getting-help/">Support</a></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a class="navbar__link" aria-haspopup="true" aria-expanded="false" role="button" href="/accessiblity/">2.7</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/3.0/administration/install/">3.0</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/administration/install/">2.7</a></li><li><a class="dropdown__link" href="/2.6/administration/install/">2.6</a></li><li><a class="dropdown__link" href="/2.5-legacy/administration/install/">2.5-legacy</a></li></ul></div><a href="https://github.com/bigbluebutton/bigbluebutton/tree/v3.0.x-release/docs" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="Switch between dark and light mode (currently light mode)" aria-label="Switch between dark and light mode (currently light mode)" aria-live="polite"><svg viewBox="0 0 24 24" width="24" height="24" class="lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" class="darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><div class="navbar__search searchBarContainer_NW3z"><input placeholder="Search" aria-label="Search" class="navbar__search-input"><div class="loadingRing_RJI3 searchBarLoadingRing_YnHq"><div></div><div></div><div></div><div></div></div></div></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0"><div class="docsWrapper_hBAB"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docRoot_UBD9"><aside class="theme-doc-sidebar-container docSidebarContainer_YfHR"><div class="sidebarViewport_aRkj"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible menu__list-item-collapsible--active"><a class="menu__link menu__link--sublist menu__link--active" aria-current="page" href="/administration/install/">Administration</a><button aria-label="Collapse sidebar category 'Administration'" aria-expanded="true" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/administration/install/">Install BigBlueButton</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/configuration-files/">Configuration Files</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/bbb-conf/">bbb-conf tool</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/firewall-configuration/">Firewall Configuration</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/customize/">Server Customization</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/monitoring/">Server Monitoring</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/turn-server/">Turn Server Configuration</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/cluster-proxy/">Cluster Proxy Configuration</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/lti/">BigBlueButton LTI</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/privacy/">Privacy</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/administration/nextcloud/">Nextcloud</a></li></ul></li></ul></nav></div></div></aside><main class="docMainContainer_TBSr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">Administration</span><meta itemprop="position" content="1"></li></ul></nav><span class="theme-doc-version-badge badge badge--secondary">Version: 2.7</span><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Install BigBlueButton</h1></header><p>We have tools to make it easy for you, a system administrator, to install BigBlueButton on a dedicated linux server. This document shows you how to install.</p> <h2 class="anchor anchorWithStickyNavbar_LWe7" id="before-you-install">Before you install<a href="#before-you-install" class="hash-link" aria-label="Direct link to Before you install" title="Direct link to Before you install"></a></h2> <p>We recommend installing BigBlueButton with a 'clean' and dedicated Ubuntu 20.04 64-bit server with no prior software installed. If you want to upgrade from an earlier version of BigBlueButton like 2.4, we recommend setting up a clean server for BigBlueButton 2.7 on Ubuntu 20.04 and, after setup, <a href="/administration/customize/#transfer-published-recordings-from-another-server">migrate over your existing recordings</a>. We support upgrading a BigBlueButton 2.5 or 2.6 server to 2.7.</p> <p>A 'clean' server does not have any previous web servers installed (such as apache) or web applications (such as plesk or webadmin) that are <a href="/support/faq/#we-recommend-running-bigbluebutton-on-port-80443">binding to port 80/443</a>. By 'dedicated' we mean that this server won't be used for anything else besides BigBlueButton (and possibly BigBlueButton-related applications such as <a href="/greenlight/v3/install/">Greenlight</a>).</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="minimum-server-requirements">Minimum server requirements<a href="#minimum-server-requirements" class="hash-link" aria-label="Direct link to Minimum server requirements" title="Direct link to Minimum server requirements"></a></h3> <p>For production, we recommend the following minimum requirements</p> <ul> <li>Ubuntu 20.04 64-bit OS running Linux kernel 5.x</li> <li>Latest version of docker installed</li> <li>16 GB of memory with swap enabled</li> <li>8 CPU cores, with high single-thread performance</li> <li>500 GB of free disk space (or more) for recordings, or 50GB if session recording is disabled on the server.</li> <li>TCP ports 80 and 443 are accessible</li> <li>UDP ports 16384 - 32768 are accessible</li> <li>250 Mbits/sec bandwidth (symmetrical) or more</li> <li>TCP port 80 and 443 are <strong>not</strong> in use by another web server or reverse proxy</li> <li>A hostname (such as bbb.example.com) for setup of a SSL certificate</li> <li>IPV4 and IPV6 address</li> </ul> <p>If you install BigBlueButton on a virtual machine in the cloud, we recommend you choose an instance type that has dedicated CPU. These are usually called "compute-intensive" instances. On Digital Ocean we recommend the c-8 compute intensive instances (or larger). On AWS we recommend c5a.2xlarge (or larger). On Hetzner we recommend the AX51 servers or CCX32 instances.</p> <p>If you are setting up BigBlueButton for local development on your workstation, you can relax some of the above requirements as there will only be few users on the server. Starting with the above requirements, you can reduce them as follows</p> <ul> <li>4 CPU cores/8 GB of memory</li> <li>Installation on a local VM container</li> <li>50G of disk space</li> <li>IPV4 address only</li> </ul> <p>Regardless of your environment, the setup steps will include configuring a SSL certificate on the nginx server. Why? All browsers now require a valid SSL certificate from the web server when a page requests access to the user's webcam or microphone via web real-time communications (WebRTC). If you try to access a BigBlueButton server with an IP address only, the browsers will block BigBlueButton client from accessing your webcam or microphone.</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="pre-installation-checks">Pre-installation checks<a href="#pre-installation-checks" class="hash-link" aria-label="Direct link to Pre-installation checks" title="Direct link to Pre-installation checks"></a></h3> <p>Got a Ubuntu 20.04 64-bit server ready for installation? Great! But, before jumping into the installation section below, let's do a few quick configuration checks to make sure your server meets the minimum requirements.</p> <p>Doing these checks will significantly reduce the chances you'll hit a problem during installation.</p> <p>First, check that the locale of the server is <code>en_US.UTF-8</code>.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ cat /etc/default/locale</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">LANG="en_US.UTF-8"</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>If you don't see <code>LANG="en_US.UTF-8"</code>, enter the following commands to set the local to <code>en_US.UTF-8</code>.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">sudo apt-get install -y language-pack-en</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">sudo update-locale LANG=en_US.UTF-8</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>and then log out and log in again to your SSH session -- this will reload the locale configuration for your session. Run the above command <code>cat /etc/default/locale</code> again. Verify you see only the single line <code>LANG="en_US.UTF-8"</code>.</p> <p>Note: If you see an additional line <code>LC_ALL=en_US.UTF-8</code>, then remove the entry for <code>LC_ALL</code> from <code>/etc/default/locale</code> and logout and then log back in once more.</p> <p>Next, do <code>sudo systemctl show-environment</code> and ensure you see <code>LANG=en_US.UTF-8</code> in the output.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ sudo systemctl show-environment</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">LANG=en_US.UTF-8</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>If you don't see this, do <code>sudo systemctl set-environment LANG=en_US.UTF-8</code> and run the above <code>sudo systemctl show-environment</code> again and confirm you see <code>LANG=en_US.UTF-8</code> in the output.</p> <p>Next, check that your server has (at lest) 16G of memory using the command <code>free -h</code>. Here's the output from one of our test servers.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ free -h</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> total used free shared buff/cache available</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Mem: 15G 3.1G 1.0G 305M 11G 12G</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Swap: 0B 0B 0B</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Here it shows 15G of memory (that's close enough as the server has 16 gigabytes of memory).</p> <p>If you see a value for <code>Mem:</code> in the <code>total</code> column less than 15G, then your server has insufficient memory to run BigBlueButton in production. You need to increase the server's memory to (at least) 16G. (As stated above, if your running this in a development environment, 8G is fine.)</p> <p>Next, check that the server has Ubuntu is 20.04 as its operating system.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ cat /etc/lsb-release</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">DISTRIB_ID=Ubuntu</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">DISTRIB_RELEASE=20.04</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">DISTRIB_CODENAME=focal</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">DISTRIB_DESCRIPTION="Ubuntu 20.04.4 LTS"</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Next, check that your server is running the 64-bit version of Ubuntu 20.04.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ uname -m</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">x86_64</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Next, check that your server supports IPV6.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ ip addr | grep inet6</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">inet6 ::1/128 scope host</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>If you do not see the line <code>inet6 ::1/128 scope host</code> then after you install BigBlueButton you will need to modify the configuration for FreeSWITCH to <a href="/support/troubleshooting/#freeswitch-fails-to-bind-to-port-8021">disable support for IPV6</a>.</p> <p>Next, check that your server is running Linux kernel 5.x.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ uname -r</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">5.4.x-xx-generic</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Next, check that your server has (at least) 8 CPU cores</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ grep -c ^processor /proc/cpuinfo</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">8</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Next check that your server has the port 80 and 443 open</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ sudo ufw status</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">...</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">80 ALLOW Anywhere</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">443 ALLOW Anywhere</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">...</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">80 (v6) ALLOW Anywhere</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">443 (v6) ALLOW Anywhere</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>If you don't see these lines, you need to open them by</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">sudo ufw allow 80</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">sudo ufw allow 443</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Sometimes we get asked "Why are you only supporting Ubuntu 20.04 64-bit?". The answer is based on choosing quality over quantity. Long ago we concluded that its better for the project to have solid, well-tested, well-documented installation for a specific version of Linux that works really, really well than to try and support may variants of Linux and have none of them work well.</p> <p>At the moment, the requirement for docker may preclude running 2.7 within some virtualized environments; however, it ensures libreoffice runs within a restricted sandbox for document conversion. We are exploring if we can run libreoffice within systemd (such as systemd-nspawn).</p> <h2 class="anchor anchorWithStickyNavbar_LWe7" id="install">Install<a href="#install" class="hash-link" aria-label="Direct link to Install" title="Direct link to Install"></a></h2> <p>To install BigBlueButton, use <a href="https://github.com/bigbluebutton/bbb-install/blob/v2.7.x-release/bbb-install.sh" target="_blank" rel="noopener noreferrer">bbb-install.sh</a> script. Notice that this command is slightly different than what we recommended in previous versions of BigBlueButton. The script now resides on a branch specifying the version of BigBlueButton, but otherwise the name of the script is identical accross different branches. This makes it more maintainable as patches done to the script in one branch can be easily applied to other branches.</p> <p>The above link gives detailed information on using the script. As an example, passing several arguments to the script you can easily have both BigBlueButton and Greenlight or LTI installed on the same server. You could specify if you would like a new certificate to be generated. A firewall could be enabled. For the most up-to-date information, please refer to the instructions in the script. Notice that as of BigBlueButton 2.6 we have retired the API demos. We recommend using Greenlight or <a href="https://mconf.github.io/api-mate/" target="_blank" rel="noopener noreferrer">API MATE</a> instead.</p> <p>Note: You can <a href="/greenlight/v3/install/#uninstall">uninstall Greenlight</a> if you do not intend on using it on production.</p> <p>After the <code>bbb-install.sh</code> script finishes, you can check the status of your server with <code>bbb-conf --check</code>. When you run this command, you should see output similar to the following:</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ sudo bbb-conf --check</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">root@test27:~# bbb-conf --check</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">BigBlueButton Server 2.7.0-alpha.1 (114)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> Kernel version: 5.4.0-122-generic</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> Distribution: Ubuntu 20.04.6 LTS (64-bit)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> Memory: 8148 MB</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> CPU cores: 4</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/etc/bigbluebutton/bbb-web.properties (override for bbb-web)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties (bbb-web)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> bigbluebutton.web.serverURL: https://test27.bigbluebutton.org</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> defaultGuestPolicy: ALWAYS_ACCEPT</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> defaultMeetingLayout: CUSTOM_LAYOUT</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/etc/nginx/sites-available/bigbluebutton (nginx)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> server_name: test27.bigbluebutton.org</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> port: 80, [::]:80127.0.0.1:82 http2 proxy_protocol, [::1]:82 http2127.0.0.1:81 proxy_protocol, [::1]:81</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/opt/freeswitch/etc/freeswitch/vars.xml (FreeSWITCH)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> local_ip_v4: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> external_rtp_ip: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> external_sip_ip: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/opt/freeswitch/etc/freeswitch/sip_profiles/external.xml (FreeSWITCH)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> ext-rtp-ip: $${local_ip_v4}</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> ext-sip-ip: $${local_ip_v4}</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> ws-binding: 143.198.37.212:5066</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> wss-binding: 143.198.37.212:7443</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">UDP port ranges</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> FreeSWITCH: 16384-24576</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> kurento: 24577-32768</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> bbb-webrtc-sfu: 24577-32768</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> bbb-webrtc-recorder: 24577-32768</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/usr/local/bigbluebutton/core/scripts/bigbluebutton.yml (record and playback)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> playback_host: test27.bigbluebutton.org</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> playback_protocol: https</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> ffmpeg: 4.2.7-0ubuntu0.1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/usr/share/bigbluebutton/nginx/sip.nginx (sip.nginx)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> proxy_pass: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> protocol: http</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/usr/local/bigbluebutton/bbb-webrtc-sfu/config/default.yml (bbb-webrtc-sfu)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/etc/bigbluebutton/bbb-webrtc-sfu/production.yml (bbb-webrtc-sfu - override)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> mediasoup.webrtc.*.announcedIp: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> mediasoup.plainRtp.*.announcedIp: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> kurento.ip: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> kurento.url: ws://127.0.0.1:8888/kurento</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> freeswitch.sip_ip: 143.198.37.212</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> recordingAdapter: Kurento</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> recordScreenSharing: true</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> recordWebcams: true</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> codec_video_main: VP8</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> codec_video_content: VP8</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/etc/bbb-webrtc-recorder/bbb-webrtc-recorder.yml (bbb-webrtc-recorder)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/etc/bigbluebutton/bbb-webrtc-recorder.yml (bbb-webrtc-recorder - override)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> debug: false</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> recorder.directory: /var/lib/bbb-webrtc-recorder</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/usr/share/meteor/bundle/programs/server/assets/app/config/settings.yml (HTML5 client)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">/etc/bigbluebutton/bbb-html5.yml (HTML5 client config override)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> build: 13</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> kurentoUrl: wss://test27.bigbluebutton.org/bbb-webrtc-sfu</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> defaultFullAudioBridge: fullaudio</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> defaultListenOnlyBridge: fullaudio</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> sipjsHackViaWs: true</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"># Potential problems described below</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Any output that followed <code>Potential problems</code> <strong>may</strong> indicate configuration errors or installation errors. In many cases, the messages will give you recommendations on how to resolve the issue.</p> <p>You can also use <code>sudo bbb-conf --status</code> to check that all the BigBlueButton processes have started and are running.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ sudo bbb-conf --status</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">nginx —————————————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">freeswitch ————————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">redis-server ——————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-apps-akka —————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-fsesl-akka ————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">mongod ————————————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-html5 —————————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-html5-backend@1 ———► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-html5-backend@2 ———► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-html5-frontend@1 ——► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-html5-frontend@2 ——► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-webrtc-sfu ————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-webrtc-recorder ———► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">kurento-media-server ——► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">etherpad ——————————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-web ———————————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-pads ——————————————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-export-annotations ► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-rap-caption-inbox —► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-rap-resque-worker —► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">bbb-rap-starter ———————► [✔ - active]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>You can also use <code>dpkg -l | grep bbb-</code> to list all the core BigBlueButton packages (your version numbers may be slightly different).</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain"># dpkg -l | grep bbb-</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-apps-akka 1:2.7-10 all BigBlueButton Apps (Akka)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-config 1:2.7-14 amd64 BigBlueButton configuration utilities</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-etherpad 1:2.7-4 amd64 The EtherPad Lite components for BigBlueButton</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-export-annotations 1:2.7-7 amd64 BigBlueButton Export Annotations</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-freeswitch-core 2:2.7-3 amd64 BigBlueButton build of FreeSWITCH</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-freeswitch-sounds 1:2.7-3 amd64 FreeSWITCH Sounds</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-fsesl-akka 1:2.7-7 all BigBlueButton FS-ESL (Akka)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-html5 1:2.7-13 amd64 The HTML5 components for BigBlueButton</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-html5-nodejs 1:2.7-4 amd64 Include a specific NodeJS version for bbb-html5</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-learning-dashboard 1:2.7-5 amd64 BigBlueButton bbb-learning-dashboard</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-libreoffice-docker 1:2.7-2 amd64 BigBlueButton setup for LibreOffice running in docker</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-mkclean 1:2.7-3 amd64 Clean and optimize Matroska and WebM files</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-pads 1:2.7-6 amd64 BigBlueButton Pads</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-playback 1:2.7-4 amd64 BigBlueButton playback</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-playback-presentation 1:2.7-3 amd64 BigBluebutton playback of presentation</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-record-core 1:2.7-4 amd64 BigBlueButton record and playback</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-web 1:2.7-8 amd64 BigBlueButton API</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-webrtc-recorder 1:2.7-2 amd64 BigBlueButton WebRTC Recorder</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ii bbb-webrtc-sfu 1:2.7-9 amd64 BigBlueButton WebRTC SFU</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>With Greenlight installed (that was the <code>-g</code> option), you can open <code>https://<hostname></code> in a browser (where <code><hostname></code> is the hostname you specified in the <code>bbb-install.sh</code> command), create a local account, create a room and join it.</p> <p><img decoding="async" loading="lazy" alt="BigBlueButton&#39;s Greenlight Interface" src="/assets/images/greenlight_welcome-f4201122f6ef3677664fee7ed95413ce.png" width="1213" height="812" class="img_ev3q"></p> <p>You can integrate BigBlueButton with one of the 3rd party integrations by providing the integration of the server's address and shared secret. You can use <code>bbb-conf</code> to display this information using <code>bbb-conf --secret</code>.</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ sudo bbb-conf --secret</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> URL: https://bbb.example.com/bigbluebutton/</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> Secret: 330a8b08c3b4c61533e1d0c334</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> Link to the API-Mate:</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> https://mconf.github.io/api-mate/#server=https://bbb.example.com/bigbluebutton/&sharedSecret=330a8b08c3b4c61533e1d0c334</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>The link to API-Mate will open a page at <a href="https://mconf.github.io/api-mate/" target="_blank" rel="noopener noreferrer">https://mconf.github.io/api-mate/</a> and let you send valid API calls to your server. This makes it easy for testing wihthout any frontend like Greenlight.</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="configure-the-firewall-if-required">Configure the firewall (if required)<a href="#configure-the-firewall-if-required" class="hash-link" aria-label="Direct link to Configure the firewall (if required)" title="Direct link to Configure the firewall (if required)"></a></h3> <p>Do you have a firewall between you and your users? If so, see <a href="/administration/firewall-configuration/">configuring your firewall</a>.</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="upgrading-bigbluebutton-27">Upgrading BigBlueButton 2.7<a href="#upgrading-bigbluebutton-27" class="hash-link" aria-label="Direct link to Upgrading BigBlueButton 2.7" title="Direct link to Upgrading BigBlueButton 2.7"></a></h3> <p>You can upgrade by re-running the <code>bbb-install.sh</code> script again -- it will download and install the latest release of BigBlueButton 2.7.</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="upgrading-from-bigbluebutton-25-or-26">Upgrading from BigBlueButton 2.5 or 2.6<a href="#upgrading-from-bigbluebutton-25-or-26" class="hash-link" aria-label="Direct link to Upgrading from BigBlueButton 2.5 or 2.6" title="Direct link to Upgrading from BigBlueButton 2.5 or 2.6"></a></h3> <p>You can upgrade in a few steps:</p> <p>Make sure you don't have <code>bbb-demo</code> installed <code>sudo apt purge bbb-demo</code></p> <p>Then run the <code>bbb-install.sh</code> script -- it will download and install the latest release of BigBlueButton 2.7 on top of your old 2.5 version.</p> <p>Make sure you read through the <a href="https://docs.bigbluebutton.org/2.7/new-features" target="_blank" rel="noopener noreferrer">"what's new in 2.7" document</a> and specifically <a href="https://docs.bigbluebutton.org/2.7/new-features#other-notable-changes" target="_blank" rel="noopener noreferrer">the section covering notable changes</a></p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="upgrading-from-bigbluebutton-24">Upgrading from BigBlueButton 2.4<a href="#upgrading-from-bigbluebutton-24" class="hash-link" aria-label="Direct link to Upgrading from BigBlueButton 2.4" title="Direct link to Upgrading from BigBlueButton 2.4"></a></h3> <p>If you are upgrading BigBlueButton 2.4 or 2.3 we recommend you set up a new Ubuntu 20.04 server with BigBlueButton 2.7 and then <a href="/administration/customize/#transfer-published-recordings-from-another-server">copy over your existing recordings from the old server</a>.</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="restart-your-server">Restart your server<a href="#restart-your-server" class="hash-link" aria-label="Direct link to Restart your server" title="Direct link to Restart your server"></a></h3> <p>You can restart and check your BigBlueButton server at any time using the commands</p> <div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">sudo bbb-conf --restart</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">sudo bbb-conf --check</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>The <code>bbb-conf --check</code> scans some of the log files for error messages. Again, any output that followed <code>Potential problems</code> <strong>may</strong> indicate configuration errors or installation errors. In many cases, the messages will give you recommendations on how to resolve the issue.</p> <p>If you see other warning messages check out the <a href="/support/troubleshooting/">troubleshooting installation</a>.</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="post-installation-steps">Post installation steps<a href="#post-installation-steps" class="hash-link" aria-label="Direct link to Post installation steps" title="Direct link to Post installation steps"></a></h3> <p>If this server is intended for production, you should also</p> <ul> <li><a href="/administration/customize/#secure-your-system--restrict-access-to-specific-ports">Secure your system -- restrict access to specific ports</a></li> <li><a href="/administration/firewall-configuration/">Configure the server to work behind a firewall</a> (if you have installed behind a firewall or on a server that has a public/private IP address)</li> <li><a href="/greenlight/v3/install/#uninstall">remove Greenlight</a> (if you had it installed and is no longer needed)</li> <li><a href="/administration/turn-server/">Set up a TURN server</a> (if your server is on the Internet and you have users accessing it from behind restrictive firewalls)</li> <li>Test your HTTPS configuration. A well-respected site that can do a series of automated tests is <a href="https://www.ssllabs.com/ssltest/" target="_blank" rel="noopener noreferrer">https://www.ssllabs.com/ssltest/</a> - simply enter your server's hostname, optionally check the "Do not show results" check box if you would like to keep it private, then Submit. At time of writing, the configuration shown on this page should achieve an "A" ranking in the SSL Labs test page.</li> </ul> <p>We provide publically accessible servers that you can use for testing:</p> <ul> <li><a href="https://demo.bigbluebutton.org/" target="_blank" rel="noopener noreferrer">https://demo.bigbluebutton.org</a> - a pool of BigBlueButton servers with the Greenlight front-end (sometimes the pool is a mix of different BigBlueButton releases)</li> <li><a href="https://test27.bigbluebutton.org" target="_blank" rel="noopener noreferrer">https://test27.bigbluebutton.org</a> - Runs the general build of BigBlueButton 2.7 - usually a few days behind the repository branch <code>v2.7.x-release</code></li> </ul> <p>To learn more about integrating BigBlueButton with your application, check out the <a href="/development/api/">BigBlueButton API documentation</a>. To see videos of BigBlueButton HTML5 client, see <a href="https://bigbluebutton.org/html5" target="_blank" rel="noopener noreferrer">https://bigbluebutton.org/html5</a>.</p> <h2 class="anchor anchorWithStickyNavbar_LWe7" id="other-installation-options">Other installation options<a href="#other-installation-options" class="hash-link" aria-label="Direct link to Other installation options" title="Direct link to Other installation options"></a></h2> <p>There are members of the community that provide other installation options for BigBlueButton.</p> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="ansible">Ansible<a href="#ansible" class="hash-link" aria-label="Direct link to Ansible" title="Direct link to Ansible"></a></h3> <p>If you're looking to deploy a large-scale installation of BBB using <a href="https://github.com/blindsidenetworks/scalelite" target="_blank" rel="noopener noreferrer">Scalelite</a> then your servers are best managed using tools like Ansible. A few reasons you might go with this setup are:</p> <ul> <li>easily customizable: your custom configurations will get replaced every time you upgrade automatically</li> <li>parity across machines: ensure that you deploy the exact same version of BBB on every server</li> <li>eliminate human error in setup: using bbb-install.sh or step-by-step methods are highly prone to human error as you can easily forget if you enabled a setting, chose to do X over Y, etc</li> <li>automate to the fullest: by automating the process, you inherently save time on nasty troubleshooting and hours lost in manual configuration</li> <li>easily scale at large: spin up an identical replica of your BBB server in less than 15 mins with no user input -- preconfigured and ready to go</li> </ul> <p>Choose this method if you are already comfortable with a lot of the technical knowledge behind BigBlueButton, Scalelite and Greenlight/other front-ends. Refer to the following examples to create your installation.</p> <p>Note: These examples are <em>not</em> maintained or developed by the official BigBlueButton developers. These are entirely community-sourced, use at your own discretion.</p> <p>The first install BigBlueButton on your server in a consistent fashion. You can specify variables, such as what ports to use for TURN, and others. Functionally quite similar to bbb-install.sh but highly automated.</p> <ul> <li><a href="https://github.com/ebbba-org/ansible-role-bigbluebutton" target="_blank" rel="noopener noreferrer">General Ansible role for BigBlueButton</a></li> </ul> <p>Large scale deployments must include several other components in addition to the core BigBlueButton packages. These include Scalelite, Greenlight, a database, backups, nginx configurations, and more.</p> <ul> <li><a href="https://github.com/Worteks/bbb-ansible" target="_blank" rel="noopener noreferrer">Full HA setup with PeerTube, Conferences Streaming, EFK, Prometheus, backups</a></li> </ul> <h2 class="anchor anchorWithStickyNavbar_LWe7" id="customizations">Customizations<a href="#customizations" class="hash-link" aria-label="Direct link to Customizations" title="Direct link to Customizations"></a></h2> <p>See the <a href="/administration/customize/">Server customization page</a> for things you can do to adapt BigBlueButton to your environment or enable optional features after installation. For example</p> <ul> <li><a href="/administration/customize/#install-additional-recording-processing-formats">Install additional recording processing formats</a></li> <li><a href="/administration/customize/#enable-generating-mp4-h264-video-output">Enable generating mp4 (H.264) video output</a></li> </ul> <h2 class="anchor anchorWithStickyNavbar_LWe7" id="troubleshooting">Troubleshooting<a href="#troubleshooting" class="hash-link" aria-label="Direct link to Troubleshooting" title="Direct link to Troubleshooting"></a></h2> <h3 class="anchor anchorWithStickyNavbar_LWe7" id="package-locales-all-is-not-available">Package locales-all is not available<a href="#package-locales-all-is-not-available" class="hash-link" aria-label="Direct link to Package locales-all is not available" title="Direct link to Package locales-all is not available"></a></h3> <p>The package <code>bbb-libreoffice</code> needs to build a docker image for libreoffice. If you receive the following error when installing on a network behind a firewall</p> <div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">Package locales-all is not available, but is referred to by another package.</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">This may mean that the package is missing, has been obsoleted, or</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">is only available from another source</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">E: Package 'locales-all' has no installation candidate</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">E: Unable to locate package libxt6</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">E: Unable to locate package libxrender1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">The command '/bin/sh -c apt -y install locales-all fontconfig libxt6 libxrender1' returned a non-zero code: 100</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">dpkg: error processing package bbb-libreoffice-docker (--configure):</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"> installed bbb-libreoffice-docker package post-installation script subprocess returned error exit status 100</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>Ubuntu 20.04 uses systemd-resolved, which presents a local caching resolver and registers this at <code>/etc/resolv.conf</code>. If you get they above error and have a local name server, such as <code>10.11.12.13</code>, then try adding it with the hosts <code>resolv.conf</code>.</p> <div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">echo "nameserver 10.11.12.13" > /etc/resolv.conf</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div> <p>For more details see <a href="https://github.com/bigbluebutton/bbb-install/issues/385" target="_blank" rel="noopener noreferrer">this issue</a>.</p> <h2 class="anchor anchorWithStickyNavbar_LWe7" id="feedback-and-reporting-bugs">Feedback and reporting bugs<a href="#feedback-and-reporting-bugs" class="hash-link" aria-label="Direct link to Feedback and reporting bugs" title="Direct link to Feedback and reporting bugs"></a></h2> <p>If you found a reproducible bug, please report it in the <a href="https://github.com/bigbluebutton/bigbluebutton/issues" target="_blank" rel="noopener noreferrer">GitHub Issues section</a> with steps to reproduce (this will make it easier for the developers to fix the bug). Indicate in the body of the bug report that this applies to BigBlueButton 2.7 and give us the client build number, which you can find either with <code>dpkg -l | grep bbb-html5</code> or within the client in the <code>Settings -> About</code> menu..</p></div></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--next" href="/administration/install/"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Install BigBlueButton</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#before-you-install" class="table-of-contents__link toc-highlight">Before you install</a><ul><li><a href="#minimum-server-requirements" class="table-of-contents__link toc-highlight">Minimum server requirements</a></li><li><a href="#pre-installation-checks" class="table-of-contents__link toc-highlight">Pre-installation checks</a></li></ul></li><li><a href="#install" class="table-of-contents__link toc-highlight">Install</a><ul><li><a href="#configure-the-firewall-if-required" class="table-of-contents__link toc-highlight">Configure the firewall (if required)</a></li><li><a href="#upgrading-bigbluebutton-27" class="table-of-contents__link toc-highlight">Upgrading BigBlueButton 2.7</a></li><li><a href="#upgrading-from-bigbluebutton-25-or-26" class="table-of-contents__link toc-highlight">Upgrading from BigBlueButton 2.5 or 2.6</a></li><li><a href="#upgrading-from-bigbluebutton-24" class="table-of-contents__link toc-highlight">Upgrading from BigBlueButton 2.4</a></li><li><a href="#restart-your-server" class="table-of-contents__link toc-highlight">Restart your server</a></li><li><a href="#post-installation-steps" class="table-of-contents__link toc-highlight">Post installation steps</a></li></ul></li><li><a href="#other-installation-options" class="table-of-contents__link toc-highlight">Other installation options</a><ul><li><a href="#ansible" class="table-of-contents__link toc-highlight">Ansible</a></li></ul></li><li><a href="#customizations" class="table-of-contents__link toc-highlight">Customizations</a></li><li><a href="#troubleshooting" class="table-of-contents__link toc-highlight">Troubleshooting</a><ul><li><a href="#package-locales-all-is-not-available" class="table-of-contents__link toc-highlight">Package locales-all is not available</a></li></ul></li><li><a href="#feedback-and-reporting-bugs" class="table-of-contents__link toc-highlight">Feedback and reporting bugs</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">BigBlueButton</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/bigbluebutton" target="_blank" rel="noopener noreferrer" class="footer__link-item">Github<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://groups.google.com/forum/#!forum/bigbluebutton-setup" target="_blank" rel="noopener noreferrer" class="footer__link-item">Setup Forums<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://groups.google.com/forum/#!forum/bigbluebutton-users" target="_blank" rel="noopener noreferrer" class="footer__link-item">Users Forums<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://groups.google.com/forum/#!forum/bigbluebutton-dev" target="_blank" rel="noopener noreferrer" class="footer__link-item">Developers Forums<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">Support</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/support/road-map/">Road Map</a></li><li class="footer__item"><a class="footer__link-item" href="/support/faq/">FAQ</a></li><li class="footer__item"><a class="footer__link-item" href="/support/getting-help/">Getting help</a></li><li class="footer__item"><a class="footer__link-item" href="/support/troubleshooting/">Troubleshooting</a></li></ul></div><div class="col footer__col"><div class="footer__title">Resources</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://support.bigbluebutton.org/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Knowledge Base<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://bigbluebutton.org/teachers/tutorials/" target="_blank" rel="noopener noreferrer" class="footer__link-item">Tutorial Videos<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">Social</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://www.facebook.com/bigbluebutton" target="_blank" rel="noopener noreferrer" class="footer__link-item">Facebook<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/bigbluebutton" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://www.youtube.com/channel/UCYj1_2Q3HTWCAImvI6eZ0SA" target="_blank" rel="noopener noreferrer" class="footer__link-item">Youtube<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 BigBlueButton Inc., Built with Docusaurus.</div></div></div></footer></div> </body> </html>