Installation

This page covers the topic on how to install GlobalQuake.

System Requirements

GlobalQuake is a real-time earthquake monitoring application built on the Java platform. Before installing, ensure your system meets the following requirements:

RequirementMinimumRecommended
Java RuntimeBundled with the Windows appJDK 17+ for macOS/Linux, JDK 21 LTS or later recommended
CPUQuad-core CPU6-8 core CPU for smooth experience
RAM1 GB2 GB or more
Storage500 MB1 GB+
OSWindows 10+, macOS 11+, LinuxWindows 11, macOS 12+, Ubuntu 20.04+
NetworkInternet connection for real-time dataStable broadband connection
Info

GlobalQuake requires an active internet connection to connect to the data server on port 38000. Ensure your system time is synchronized correctly for proper station synchronization and earthquake detection.

Info

Currently, there is no mobile client for GlobalQuake. But it is planned in the near future.

Installation Guide - Windows

Note

The Windows download already includes the required JDK, so no separate Java installation is needed.

For returning users (Path Change)

Starting with the 1.1.2 release, GlobalQuake installs its program files according to Microsoft's best practice guidelines to %LOCALAPPDATA%\Programs\GlobalQuake, while user settings, logs, and custom sounds are kept in your Roaming profile as before (%APPDATA%\GlobalQuake).

When running the new installer, you may be prompted to delete the old installation folder. It is safe to click Yes — your existing configuration will be preserved.

Download GlobalQuake

Windows builds include the required Java runtime, so no separate Java installation is needed.

  • Visit the GlobalQuake Download Page
  • Click the Download Latest Version button
  • Select Windows and download the .exe file
  • Wait for the download to complete (typically in your Downloads folder)

Install GlobalQuake

  • Locate the downloaded .exe file in your Downloads folder
  • Double-click the installer to launch the setup wizard
  • Follow the on-screen installation steps:
    • Accept the license agreement
    • Select whether to create a desktop shortcut
  • Click Finish to complete installation

Launch and Verify

  • Launch GlobalQuake by double-clicking the desktop shortcut or navigating to
    %LOCALAPPDATA%\Programs\GlobalQuake\GlobalQuake.exe
  • Wait 2-10 seconds for the application window to appear
  • Verify successful installation:
    • ✓ The main map interface loads
    • ✓ Network status indicator shows "Connected"
    • ✓ Recent earthquakes appear on the map
  • If you see earthquake data displayed, installation is complete!

Installation Guide - macOS/Linux

Install Java Development Kit (JDK)

Linux (Ubuntu/Debian):

  • Open Terminal
  • Update your package manager:
    sudo apt update
  • Install OpenJDK 17:
    sudo apt install openjdk-17-jdk

Verify installation by opening Terminal and running:

java -version

You should see output confirming Java 17 or higher

macOS:

  • Visit the Oracle Java Downloads page
  • Under "Java 17", click the macOS tab
  • Download the appropriate installer:
    • ARM64 DMG Installer (jdk-17.x.x_macos-aarch64_bin.dmg) for Apple Silicon Macs
    • x64 DMG Installer for Intel Macs
  • Open the downloaded .dmg file by double-clicking it
  • In the mounted volume window, double-click the package file (.pkg)
  • Follow the installation wizard and enter your password when prompted

Download GlobalQuake

  • Visit the GlobalQuake Download Page
  • Click the Download Latest Version button
  • Select macOS or Linux and download the .zip file
  • Wait for the download to complete

Extract GlobalQuake

Linux:

  • Open Terminal and navigate to your Downloads folder:
    cd ~/Downloads
  • Extract the downloaded .zip file:
    unzip GlobalQuake.zip
  • (Optional) Move the extracted folder to a permanent installation directory you want to use:
    mkdir -p ~/.local/share/globalquake
    mv GlobalQuake ~/.local/share/globalquake/

macOS:

  • Open Finder and navigate to your Downloads folder
  • Locate the downloaded .zip file
  • Double-click the .zip file to extract it automatically
  • Move the extracted GlobalQuake folder to your Applications folder

Launch and Verify

Linux:

  • Open Terminal and navigate to the GlobalQuake directory where you installed it:
    cd /path/to/your/GlobalQuake
  • Run the application using the provided script from that directory:
    ./run.sh

macOS:

  • Open Finder and navigate to ApplicationsGlobalQuake
  • Double-click the run.sh file to launch GlobalQuake
    • Alternatively, open Terminal and run: ./run.sh

Wait 2-10 seconds for the application window to appear. Verify successful installation:

  • ✓ The main map interface loads
  • ✓ Network status indicator shows "Connected"
  • ✓ Recent earthquakes appear on the map

If you see earthquake data displayed, installation is complete!

Note

If stations are not appearing or synchronizing, ensure your system time is synchronized correctly. Use NTP (Network Time Protocol) to keep your clock accurate.