Download and Install CAVE

current release 17.1.1
Linux x86_64 install.sh
macOS Download and install both
32-bit Windows awips-cave.msi
64-bit Windows awips-cave.amd64.msi


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

Install CAVE for Linux

wget https://www.unidata.ucar.edu/software/awips2/install.sh
chmod 755 install.sh
sudo ./install.sh --cave

Run CAVE from the menu Applications > Internet > AWIPS CAVE, or from the command line as simply 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


CAVE for macOS requires the awips-python.pkg package be installed in order for derived parameters to work.

awips-python.pkg is not a prerequisite, and CAVE will still run and display data without it, but to use any derived parameter functions such as wind barbs/arrows and grid parameters on various vertical coordinates, jep must be installed in some way (it is assumed in /Library/Python/2.7/site-packages/jep/). You are free to install jep yourself but should know that simply to install via source code or pip requires the Oracle JDK and Xcode and its Command Line Tools. The awips-python.pkg package is provided as a workaround for this.

CAVE for macOS writes and syncs files to ~/Library/caveData


Windows clients are still based on the CAVE 16.2.2 code base and provided in lieu of no 17.1.1 client.

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

Beta status

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/caveData) 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.