How to Install Oracle Java 8 on Mac & Linux - Knowledge Base

ORO POS requires Oracle Java 8 (JDK 8) to run on Mac and Linux. This guide shows you how to download and install it on both platforms.

Step 1 — Download Oracle JDK 8

Go to the official Oracle download page and download JDK 8 for your operating system:

👉 Oracle JDK 8 Downloads — oracle.com

You will need a free Oracle account to download JDK 8. Sign up at oracle.com if you do not already have one.

Operating System	File to Download
macOS (Intel)	`jdk-8uXXX-macosx-x64.dmg`
macOS (Apple Silicon M1/M2/M3)	`jdk-8uXXX-macosx-aarch64.dmg`
Linux x64 (Debian/Ubuntu)	`jdk-8uXXX-linux-x64.tar.gz`
Linux x64 (RPM — CentOS/RHEL)	`jdk-8uXXX-linux-x64.rpm`

macOS — Installation

Download the .dmg file for your Mac from the Oracle page above.
Double-click the .dmg to mount it.
Double-click JDK 1.8.pkg inside the mounted image.
Follow the installer wizard and enter your Administrator password when prompted.
Click Close when complete.

Verify Installation

Open Terminal and run:

java -version

You should see something like:

java version "1.8.0_421"
Java(TM) SE Runtime Environment (build 1.8.0_421-b09)
Java HotSpot(TM) 64-Bit Server VM (build 25.421-b09, mixed mode)

Set JAVA_HOME (macOS)

Open Terminal and add the following to your shell config file (~/.zshrc for macOS Catalina and later, or ~/.bash_profile for older versions):

export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)
export PATH=$JAVA_HOME/bin:$PATH

Then apply it:

source ~/.zshrc

Linux — Installation

Ubuntu / Debian

Download the .tar.gz from Oracle, then run:

sudo mkdir -p /usr/lib/jvm
sudo tar -xzf jdk-8uXXX-linux-x64.tar.gz -C /usr/lib/jvm
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/jdk1.8.0_XXX/bin/java 1
sudo update-alternatives --config java

CentOS / RHEL

Download the .rpm from Oracle, then run:

sudo rpm -ivh jdk-8uXXX-linux-x64.rpm

Verify Installation (Linux)

java -version

Set JAVA_HOME (Linux)

Add the following to ~/.bashrc or /etc/profile:

export JAVA_HOME=/usr/lib/jvm/jdk1.8.0_XXX
export PATH=$JAVA_HOME/bin:$PATH

Apply it:

source ~/.bashrc

Video Guides

Linux — Install Oracle JDK 8

macOS — Install Java 8

Need help? Email helpdesk@orocube.net or call 1 (800) 844-6603.