Adrian Moya's picture


Forget about DimDim (they forgot about you anyway!). This TKLPatch will convert turnkey-core-beta-lucid-x86 image to a BigBlueButton appliance which is a wonderfull web conference system that integrates 14 opensource projects and is being actively developed. It has integrated webcam support, VoIP, Desktop Sharing, and all the features needed for this type of software. 
Developers also included a web front-end in past versions, but it's being dumped in favor to develop the API, but some examples are included in how to use the API to manage the rooms and private conference. 


Complete opensource conferencing system.
Based on Ubuntu 10.04
Script added to run bbb-conf --setip when there is a change on the IP (convenience)

What it does:

1. Set hostname to bigbluebutton
#Set hostname
echo "$HOSTNAME" > /etc/hostname
sed -i "s| \(.*\)| $HOSTNAME|" /etc/hosts
2.  Update package information
apt-get update
3. Install gnupg to required to add bigbluebutton package key
apt-get -y install gnupg
4. Add the package key
apt-key add bigbluebutton.asc
5. Add the archive for BigBlueButton Ubuntu 10.04
echo "deb bigbluebutton-lucid main" > /etc/apt/sources.list.d/bigbluebutton.list
6. Ensure the multiverse is in the souces list (needed for msttcorefonts)
echo "deb lucid multiverse" >> /etc/apt/sources.list.d/sources.list
7. Install required packages
install asterisk bigbluebutton ghostscript
8. Stop running services
service mysql stop
service nginx stop
service tomcat6 stop
service red5 stop
service asterisk stop
service activemq stop
service bbb-openoffice-headless stop
9. Clean apt cache
Enjoy. Comments, bugs, feedback are welcome.

I built the ISO using ur patch ,  When i issue the IP address on the browser , i got an option to enter a name and proceed , but nothing is happening afterwards. The load of the machine goes up high and it even doesn't reply to ssh requests. Also after some time i got " page unavailable error ".


Also i think you forgot to add script to change mysql root password during installation.

Adrian Moya's picture

Are you running live or installed? How much memory does the VM has? Also, be sure to have latest adobe flash plugin installed on the client browser. 

The fact that doesn't reply to ssh request suggests that maybe the vm is dying. Which hypervisor are you using? (ex Virtualbox, VMWare)? 

I don't usually change mysql root password when the app doesn't manage sensitive data. Either way, we may as community stablish some recommendations about this topic. I can add that to this patch in a future version. 

Thanks for your comments! Please keep me informed is you could successfully run this appliance.

I tried running live , later i installed it too .

256 MB was given to the VM.

Some version 10 of adobe flash is installed . I can use the BBB demo on Project website in the same browser.


I 'm using VirtualBox 3.2.8

Adrian Moya's picture

WOW, 256mb is a small amount of memory for this appliance. Pump the memory to 1GB. This appliance is running a lot (A LOT!) of software underneath. That's why your appliance is hanging. I'll paste here the requirements from the bigbluebutton page:

We recommend you run BigBlueButton on dual core machine with at least 1 Gig of memory and a 2.0+ Ghz processor. Any new PC you buy today will be sufficent for a BigBlueButton server. You'll need good upstream and downstream bandwidth from the server.

Sorry , In the current scenario, i 'm unable to give 1GB memory to VM.

Liraz Siri's picture

With at least 4GB of RAM. Better yet 8GB. :)
Liraz Siri's picture

Excellent find Adrian! When I wrote the TKLPatch contest post I didn't realize DimDim sold out and gave the middle finger to the open source community.

BigBlueButton wasn't even on my radar but it looks like an excellent alternative to DimDim and a perfect match for cloud deployment to boot!

I see those guys maintain their own Ubuntu package repository. That not only makes the integration easier, but will also make BigBlueButton's components easier to update.

The only thing I might look into improving is enabling SSL access to the web application part.

Guest's picture

How do you install it? yes I am a linux nubi, so be kind. Im using virtualbox for my dev. Thanks.

Adrian Moya's picture

We all were newbies once. So don't feel stupid. The procedure is not very easy right know, as this is a patch and not the final appliance (which will install very easy). I'll try to give you a quick explanation:

1. Download TKL Lucid Core beta here. Click on the 144MB ISO link. 

2. Create a VM in vbox with 512mb ram and set network to bridge and OS to linux/ubuntu. And install TKL Lucid Core. You can use this as a guide. Follow the iso instructions. The current VBox version differs a bit but you shouldn't find any problems.

3. Run your new Core system and apply the patch following this instructions.

4. You'll end up with an iso file which you can install as point 1. 


Sorry there is no easy way yet to apply patches, I'm working on it and I hope to have a web interface to apply patches soon. 

Hope this helps a bit!

danielico3's picture

Buenas, resulta que intento instalar bigbluebutton en una maquina Debian 4.1.3, he leido por todos sitios que es muy sencillo pero yo por más que lo estoy intentando no consigo poder instalar.


Pensaba que desde aqui lo podría conseguir, pero lo he intentado desde las 2 versiones que hay y no se instala.

Lo he intentado instalando paquete por paquete pero tamcpo. Puede ser que el problema este en el tipo de SO Debian??


Un saludo y os agradecería cualquier ayuda

Adrian Moya's picture

You need a lot of new packages which are surely not available in debian 4. If you still want debian, maybe you can try with debian 5, although installation instructions specifically say ubuntu 10.04.  

Please keep the forum post in english as it's the official language. In the future, there might be a spanish forum for TKL. 


No podrás instalar en debian 4 por ser una distribución muy vieja que no tiene en sus repos oficiales los paquetes que necesita BBB. Asi que debes utilizar ubuntu 10.04, o quizá intentar con debian 5 a ver si tienes suerte. Te recomendaría utilizar este appliance una vez que salga la versión oficial. 

Si puedes mantener la conversación en inglés, es el lenguaje oficial del foro. Saludos!

Jonathan's picture

Hello, thank you for all the work and help you gave here.

I'm writting because i have a LITTLE (a big one really) problem when i'm trying to install the BigBlueButton (BBB) on a Ubuntu 10.04 server VM. I did follow all the official procedures step by step without success. So i've got a few questions:

I'm using Citrix XenServer 5.6 as hypervisory and i'd like to know if there is a way to import your Vmware VM's into the XenServer AND install de xenserver-tools with success?

If i can't import the turnkeylinux VMs into the citrix, with a fresh installation can i later install the xenserver tools? (i know it's a little complicated but possible to install ubuntu with xen-tools in citrix)

Is there a difference between official BBB installing procedure and your patch?

Thanks in advance.

P.S.: excuse me for my bad English, my native language is Spanish. By the way i'm n00b in linux too.

Adrian Moya's picture

And import it on XenServer, however, XenServer doesn't support ubuntu as guest OS (at least in XS5.5). So you'll be missing a kernel for your VM to run the server in paravirtualization mode (and enable xentools), as Citrix makes they own kernels for XenServer. You're left with HVM mode. 

You can check a post I wrote more than a year ago on how to create a functional ubuntu server running on XenServer, but I don't know if will work for ubuntu 10.04 on XS5.6. But you could try and post your results!

Anyway, I'd recommend you if it's possible to change from XS to other solution. Maybe VMWare Server or Proxmox? Which already support ubuntu. 

Guest's picture

Patch process was way to hard for a noob. Docs not clear and consise and detailed enough for somone with little experiance. I just could not figure it out.  What I did was start with core VM and use install instructions on BBB, worked great. Took all of 20 min. Instead of the 3 hrs I fooled with the patch to no avail. Even though that was my experiance with it, I certanly appreciate that the patch is there and the effort it took to creat it.

Adrian Moya's picture

But I'm currently working on a web based patch tool as part of my TKLDevEnv project. So things like patching an iso are going to be plain simple. Stay tuned for updates on this forum. 

Anyway, remember the patches have "overlayed files". In the case of this one you'll only miss a script I did to reconfigure BBB when you change the ip address, but in other patches things may get broken only by following the instructions (without adding the overlay). 

If you have any issue, feel free to post it here so we are able to help!

Jeremy Davis's picture

Adrian's project will definately make it much easier, especially for newbs. But still, the TKL community would like the docs to be user friendly, even for newbs (probably especially for newbs!)

Can you please elaborate on what part of the TKLPatch docs you found unclear and confusing so we can try to make it better? Your feedback would be invaluable because IMO it should take only 10-15 min to create a patched ISO and install from it, even less if you patch an already installed copy of TKL-Core (more like 5 mins) - certainly nothing like 3 hours! Although I guess because I'm used to using it perhaps I'm getting a little overexcited?

Jonathan's picture

Thanks for you reply.

I have to say that, Yes, it's possible to make a running Ubuntu 10.04 in Citrix, i found this

and i have to say that it's works, i can copy and paste through the console and make a clean poweroff. I tried to use your patch but i have two issues.

1. I don't have idea that how to install the TLKPatch package, the ubuntu tell me that isn't a package with that name, i did install a TKL-core-base from the official iso but it can't find that package too.

2. I'm not sure if your patch works on ubuntu 10.04 x64 to used on the template i found early.


By the way, the virtualization solution that you said are totally free? (for basic operation of course)


Thanks in advance again.

Adrian Moya's picture

Nice to see it's easiest than before! From BBB official page, they say that they support 64 bits packages under ubuntu 10.04. So it may work, but I haven't tested. 

This patches are aimed at the TKL-Core-Lucid-beta, did you install that one? There is a bug in the Core which prevents the VM to get a gateway on boot. To overcome this issue, just use the confconsole to reset network settings (Advanced menu->Networking->DHCP). Verify you get a gateway, and then apt-get update and apt-get install tklpatch. 

The result of the patching will be an iso which you can use to install BBB. Just remember the resulting iso will inherit the same network problem. Today Alon twitted that the RC for TKL 10.04 is about to see the light, so keep in touch as this new TKL-Core-Lucid will surely have this problem fixed and be more stable. 

OTOH, 64 bit images are planned but currently none exists. 

I changed from XenServer to Proxmox for many reasons, but the main one is that Proxmox-VE is completely free and opensource, and has a webpanel, so you don't need XenCenter which made me had an extra VM (As my main OS is ubuntu). I'd recommend that you take a look at it. VMWare Server (ESXi or something) is also free, but not opensource solutions, and I always end with the feeling that there will come the time I'll need something thats not free (Like access to the whole API for automation tasks)

Jonathan's picture

Yes they said that but i have several trieds withouth sucess, i tried with the "magic of ubuntu package" and nothing, i tried with the commands one by one and i have the same final issue, so i'll try your patch.

Ahmmmm, i didn't know that the beta version have that problem X_X

But, if i install another clean official Ubuntu x32, can i install the TKLpatch package and run your package? because i'll tried to make it as a new PV VM to get the tools i want to, and install the BBB with your patch.

O_o i didn't know that vmware had a free edition.

Thanks for your quickly answers.

Jeremy Davis's picture

I even installed to x64 (from source) and it seems to work ok, but I didn't end up using it because I think it may cause issues?. If you use 32 bit Ubuntu just add the repo to your sources.list. All the info you should need re TKLPatch you should find in the docs. Any problems or confusion, please ask or offer suggestions so we can try to make it clearer and easier.

BTW +1 Proxmox VE! IMO it is the go. I have raved about it lots but I think it is awesome. It includes OpenVZ (Linux container virtualisation) which has awesome performance, but also KVM for full virtualisation which can accommodate other OSs (eg Win). Facility for clustering, migration and VM backup with a powerful WebUI make Administration a breeze. Starting to sound like an ad really! :) But I'm not cause its free!!

L. Arnold's picture

I need, at least to do an Asterisk system.  There is an Adrian's Asterisk Patch.  Big Blue Button seems interesting...

Debian TKL is here now.

Best to just use Lucid and get up and running or is there a TKL Build in the system now - perhaps under a different name?

L. Arnold's picture

I will try Adrian's patch first, but I did also just find this how to that should be helpful in Debian.

More on the technical side..  wondering if I can run as a VM or do I need a dedicated box.  Should I run from My office or my CoLo?  Basically wanting a mobile operations ability, though porting into our old phone is always attractive (where a dedicated box might make sense I expect).

Add new comment