Java OceanAtlas Application

Mac Installation Instructions

  • You do not have to install a separate Java environment for JOA 5.5
  • The installation process depends on what operating system you are using. To check what version of macOS is installed on your computer, go to the apple menu in the top left corner of your screen and select About This Mac. JOA 5.5 has been tested on versions 10.12-10.15, 11, and 12 of macOS.

Installation on macOS Catalina (10.15), Big Sur (11), and Monterey (12)

  1. You must download JOA 5.5 from Safari. Open Safari and go to Preferences. In the General tab, turn on Open “safe” files after downloading. This is necessary for JOA to install correctly.

  2. Mac-1

  3. Download the Zip file.
  4. When the download is finished, there will be a folder called Java OceanAtlas in your Downloads folder that contains these files:

  5. Mac-2

  6. Move or copy the Java OceanAtlas folder to the desired location on your computer. We recommend putting it in Applications.

Installation on macOS Sierra (10.12), High Sierra (10.13), Mojave (10.14), Catalina (10.15), and Big Sur (11). Provisionally on macOS 12 (Monterey).

  1. Download the DMG file
  2. Double click Java OceanAtlas.dmg to open it. You will see this window:

  3. Mac-3

  4. Drag the folder called Java OceanAtlas to the provided link to your Applications folder, or to the desired location on your computer. Do not run JOA directly from the DMG.
  5. You will see these files in the Java OceanAtlas folder. You can now eject the DMG from finder or unmount it using the Disk Utility application. The DMG can be kept as a backup or discarded entirely.

  6. Mac-2

Fixing Blurry Fonts in JOA

If you are using Mojave or Catalina, you may notice certain text to be poorly rendered and difficult to read, such as colorbar labels:


  1. Quit JOA. Open Terminal (Terminal can be found in your /Applications/Utilities/ folder). You will see some text in your Terminal window. The gray box is your cursor.
  2. Copy and paste the following text into Terminal and press return:

    defaults write -g CGFontRenderingFontSmoothingDisabled -bool NO

  3. Mac-5

  4. After you press return, a new line of text with your computer and account name will appear. There will be nothing to indicate that a change has taken effect. Quit terminal and restart JOA. If text still appears fuzzy, try logging out of your account and logging back on.

System Requirements:

JOA 5.5: macOS 10.12 or higher (may work under previous versions of macOS but has not been tested)
JOA 5.3: Mac OS X 10.10 or higher
4 GB of RAM (standard version) or 16 GB of RAM (pro version)