Bumblebee

Revision 57 as of 2012-04-30 15:41:54

Clear message

Bumblebee Project

Bumblebee aims to provide support for NVIDIA Optimus laptops for GNU/Linux distributions. Using Bumblebee, you can use your NVIDIA card for rendering graphics which will be displayed using the Intel card.

Installation

Currently, you need to open your terminal and enter the commands below.

  1. sudo add-apt-repository ppa:bumblebee/stable

If you are on Ubuntu 11.04 or older and want newer drivers (recommended) than the ones available in the official repos, run:

  • sudo add-apt-repository ppa:ubuntu-x-swat/x-updates

  1. sudo apt-get update

  2. Install Bumblebee using the proprietary nvidia driver:

sudo apt-get install bumblebee bumblebee-nvidia

  1. Reboot or re-login

Formerly, you had to add an user manually to a group with sudo gpasswd -a $USER bumblebee. As of version 3.0-2, which was released on April 30th, this is not necessary anymore for new installations. With that version, the 32-bit libraries are also installed automatically on Oneiric and later.

For advanced users, if you do not want to use the proprietary nvidia driver or 32-bit libraries (for example, if you are only interested in power savings), install bumblebee with: sudo apt-get install --no-install-recommends bumblebee

Upgrading

If you already got Bumblebee installed on your system, upgrade to Bumblebee 3.0.

Please, follow the instructions on this wiki: https://github.com/Bumblebee-Project/Bumblebee/wiki/Upgrading-on-Ubuntu

Usage

To run your application with the discrete NVIDIA card run in the terminal:

  • $ optirun [options] <application> [application-parameters]

Example:

  • $ optirun firefox

For a list of options for optirun run:

  • $ optirun --help

Normally you do not use optirun for your window manager, installations or other non graphic heavy demanding programs. The optirun command is mainly used for graphic demanding programs or for games.

Power Management

A primary goal of this project is to not only enable use of the discrete GPU for rendering, but also to enable smart power management of the dGPU when it's not in use. We're using either bbswitch (a module) or vga_switcheroo (kernel module, experimental) to do this in Bumblebee.

Since Bumblebee 3.0, this feature is enabled by default, using bbswitch. This allow automatic power management, without any configuration needs.

If Power Management doesn't work on your laptop, please go to this Power Management (PM) page and help to improve Bumblebee.

IRC

Please join #bumblebee channel on Freenode if you wish to help testing and creating the installer.

Reporting bugs/problems

First of all: If you have any problem, please read this article: http://wiki.Bumblebee-Project.org/Troubleshooting

If your issue is not solved, you can join the #bumblebee IRC channel to ask for help (recommended). See also http://wiki.Bumblebee-Project.org/Reporting-Issues

If you're asked to create a bugreport, run the next command in a terminal: sudo bumblebee-bugreport

Uninstall

If you're unsatisfied with Bumblebee, you can remove it via:

  1. sudo apt-get purge bumblebee

  2. sudo apt-get --purge autoremove

Social Media

Follow us on: Facebook, Twitter and Google+.

CUDA

There is sometimes confusion about CUDA. You don't need Bumblebee to run CUDA. Follow the How-to to get CUDA working under Ubuntu.


CategoryHardware