Download and Install CAVE

macOS awips2-cave-16.2.2.dmg
Linux x86_64 installCAVE.sh
32-bit Windows awips-cave.msi
64-bit Windows awips-cave.amd64.msi


Download the DMG, open and drag the CAVE folder to Applications as with any other macOS application. The CAVE application will write local configuration files to ~/Library/CAVE

macOS 10.12 (Sierra) requires you remove the application from quarantine before running:

xattr -d com.apple.quarantine /Applications/CAVE/cave.app

To get around quarantine you can also run CAVE from the command line /Applications/CAVE/cave.app/Contents/MacOS/cave

Client-side Python scripting (including Derived Parameters for grid parameters) does not work on macOS


For CentOS/Red Hat 6 and 7. Installs to /awips2/cave and writes files to ~/caveData.

Install as root:

chmod 755 ./installCAVE.sh

All package dependencies should be resolved by yum.

Run CAVE from the command line


or find CAVE in the GNOME menu Applications > Internet > AWIPS CAVE

System Requirements

  • x86_64 CentOS/RHEL 6 or 7
  • OpenGL 2.0
  • 4GB RAM
  • Latest NVIDIA driver for your graphics card
  • 2GB disk space for caching datasets in ~/caveData


Writes files to caveData in the user's home directory.

Client-side Python scripts (including Derived Parameters) do not work on Windows

AWIPS Data in the Cloud

Unidata and XSEDE Jetstream have partnered to offer a EDEX data server in the cloud, open to the Unidata university community. Select the server in the Connectivity Preferences dialog, or enter edex-cloud.unidata.ucar.edu (without http:// before, or :9581/services after).

EDEX in the cloud


Localization Preferences Error

You can reset CAVE by removing the ~/caveData directory (on macOS ~/Library/CAVE) and then run cave again to connect to an EDEX server. Your local files have been removed, but if you are re-connecting to an EDEX server you have used before, the remote files will sync again to your local ~/caveData (bundles, colormaps, etc.).

No Images Displayed

If you are able to load wire-frame contours but not images, update your video driver.