bbb-conf is BigBlueButton’s configuration tool. It makes it easi for you to modify parts of BigBlueButton’s configuration, manage the BigBlueButton system (start/stop/reset), and troubleshoot potential problems with your setup.

    As a historical note, this tool was created early in the development of BigBlueButton. The core developers wrote this tool to quickly update BigBlueButton’s configuration files for setup and testing.

    bbb-conf is located in /usr/bin/bbb-conf. If you are a developer, we recommend taking a look through the source code for bbb-conf (it’s a shell script) as it will help you understand the various components of BigBlueButton and how they work together (see also Architecture Overview).


    If you type bbb-conf with no parameters it will print out the list of available options.

    $ bbb-conf
    BigBlueButton Configuration Utility - Version 2.5.2
       bbb-conf [options]
       --version                        Display BigBlueButton version (packages)
       --setip <IP/hostname>            Set IP/hostname for BigBlueButton
       --setsecret <secret>             Change the shared secret in /etc/bigbluebutton/
       --check                          Check configuration files and processes for problems
       --debug                          Scan the log files for error messages
       --watch                          Scan the log files for error messages every 2 seconds
       --network                        View network connections on 80, 443 and 1935 by IP address. 1935 is deprecated. You will need to modify bbb-conf if you have custom ports.
       --secret                         View the URL and shared secret for the server
       --lti                            View the URL and secret for LTI (if installed)
       --restart                        Restart BigBlueButton
       --stop                           Stop BigBlueButton
       --start                          Start BigBlueButton
       --clean                          Restart and clean all log files
       --status                         Display running status of components
       --zip                            Zip up log files for reporting an error

    You run bbb-conf as a normal user. If a particular command requires you to run BigBlueButton as root, it will output a message saying you need to run this command as root. Below is an outline of the various commands.


    Shows the version of BigBlueButton installed on the server and the versions of the components of BigBlueButton.

    --setip <hostname_or_ip>

    Sets the IP/Hostname for BigBlueButton’s configuration. For example, if your BigBlueButton server has the IP address of, you can change BigBlueButton’s configuration files to use this IP address with the command

    $ sudo bbb-conf --setip

    or, if you want to use the hostname, then use the command

    $ sudo bbb-conf --setip


    Restarts BigBlueButton and clears all the log files during the restart. This is good for debugging as it clears away previous errors in the log files.


    Runs a series of checks on your current setup and reports any potential problems. Not all reported problems are actual issues. For example, if you use --setip <hostname_or_IP>, then bbb-conf will complain that the hostname does not match the server’s IP, but that’s fine as you configured the BigBlueButton server to listen on a hostname instead of IP address.


    Greps through the various log files for errors (such as exceptions in the Java log files for Tomcat).


    This command shows you the number of active connections for port 80 (HTTP) and 443 (HTTPS) for each remote IP address.


    Displays the current security salt for the BigBlueButton API. For example:

    $ bbb-conf --secret
        Salt: f6c72afaaae95faa28c3fd90e39e7e6e

    --setsecret <new_secret>

    Assigns a new security secret for the BigBlueButton API. This does not change the security secret for the API demos, so if you run this command and still want to use the API demos, you’ll need to update the shared secret in /var/lib/tomcat8/webapps/demo/bbb_api_conf.jsp.


    Starts all the BigBlueButton processes.


    Stops all the BigBlueButton processes.


    Watches log files for error messages every 2 seconds. Use this command after sudo bbb-conf --clean to clean out all the log files.


    Zips up log files for reporting an error. This option is rarely used as it’s often easier to use pastebin to share the log of the error message if you are, for example, posting to the bigbluebutton-dev mailing list.