The following are methods for downloading and installing KeckCAVES and KeckCAVES-related software using package management.

If you don’t see the particular software and platform combination you are interested in, then you will probably need to install from source.


Linux is the preferred platform for running the software, as it is the platform where development takes place.


Ubuntu packages are provided via a PPA. Please visit

To add the KeckCAVES repository, fist run

sudo apt-add-repository ppa:keckcaves/ppa

then update the package lists from all repositories

sudo apt-get update

to install our software

sudo apt-get install package_name

Tip: Please visit the web page listed above for package names.

Mac OS X

Mac OS X support is done on a best effort basis. So, for example, bugs that appear only in Mac OS X will probably be of lower priority.

You might think about dual-booting your Mac with Linux.

That being said, feel free to give one of the following options a go.


There is an experimental Mac OS X binary installer and upgrader. It supports 64 bit machines with Snow Leopard (10.6), Lion (10.7), or Mountain Lion (10.8).

This installation currently includes: crusta, ShowEarthModel, LidarViewer, 3DVisualizer, and NanotechConstructionKit.

To try it out, first you’ll need to download and install XQuartz.

Then from the command line run:

bash -c "$(curl -fsSkL"

This will ask and proceed to install KeckCAVES software to /opt/keckcaves, and optionally put that software in your command path.

To upgrade your installation, just run:



If you use Homebrew on Mac OS X, there are formula for KeckCAVES and KeckCAVES-related software.

To install via Homebrew:

  1. Install Homebrew.
  2. Download and install XQuartz.
  3. In a terminal, do
brew tap KeckCAVES/keckcaves

To see all the formula available, please visit the KeckCAVES Homebrew repository. Then do, e.g.

brew install vrui-examples

To get updates, periodically do:

brew update
brew upgrade

Note: The Homebrew install will always be more up to date than the binary install mentioned above, and also gives you access to development headers. But, it is slower to install and may have more issues if your system has a lot of cruft around from other library installations.