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.
BigBlueButton Configuration Utility - Version 2.5.2
--version Display BigBlueButton version (packages)
--setip <IP/hostname> Set IP/hostname for BigBlueButton
--setsecret <secret> Change the shared secret in /etc/bigbluebutton/bbb-web.properties
--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
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.
Sets the IP/Hostname for BigBlueButton's configuration. For example, if your BigBlueButton server has the IP address of 192.168.0.211, you can change BigBlueButton's configuration files to use this IP address with the command
$ sudo bbb-conf --setip 192.168.0.211
or, if you want to use the hostname bbb.mybbbserver.com, then use the command
$ sudo bbb-conf --setip bbb.mybbbserver.com
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
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
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.