ORO POS runs on any modern Linux distribution using Java 8. This guide provides exact installation commands for the most common distros and covers Raspberry Pi separately. Java is not bundled — install it once using the commands below, then run ORO POS from the terminal.
|
Jump to your distribution |
Ubuntu 20.04 / 22.04 / 24.04
OpenJDK 8 is available directly from Ubuntu's package manager:
sudo apt update sudo apt install -y openjdk-8-jdk java -version
If openjdk-8-jdk is not found on Ubuntu 24.04, install it via the deadsnakes PPA:
sudo add-apt-repository ppa:openjdk-r/ppa sudo apt update sudo apt install -y openjdk-8-jdk
If you have multiple Java versions, set Java 8 as default:
sudo update-alternatives --config java # Select the entry showing java-8
Debian 10 (Buster) / 11 (Bullseye) / 12 (Bookworm)
sudo apt update sudo apt install -y openjdk-8-jdk java -version
âš Debian 12 Bookworm: OpenJDK 8 was removed from the default repos. Install from Debian Backports:
echo "deb http://deb.debian.org/debian bookworm-backports main" | sudo tee /etc/apt/sources.list.d/backports.list sudo apt update sudo apt -t bookworm-backports install -y openjdk-8-jdk |
CentOS 7 / RHEL 7
sudo yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel java -version
Set as default if needed:
sudo alternatives --config java # Select the java-1.8.0 entry
CentOS 8 / RHEL 8 & 9 / Rocky Linux / AlmaLinux
sudo dnf install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel java -version
Set as default:
sudo alternatives --config java # Select the java-1.8.0 entry
ℹ RHEL 9 / AlmaLinux 9 / Rocky 9: Java 8 packages may be in the java-1.8.0-openjdk module stream. If not found, enable it first: sudo dnf module enable java:8
|
Fedora (38 / 39 / 40 / 41)
sudo dnf install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel java -version
Raspberry Pi OS (Pi 3 / Pi 4 / Pi 5)
Raspberry Pi runs on ARM architecture. Oracle JDK 8 does not provide ARM builds. Use Azul Zulu JDK 8 — a certified, free OpenJDK distribution with full ARM support.
Raspberry Pi OS (64-bit) — Pi 4 & Pi 5 (recommended)
# Install dependencies sudo apt update sudo apt install -y curl gnupg # Add Azul Zulu repository curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list # Install Zulu JDK 8 sudo apt update sudo apt install -y zulu8-jdk # Verify java -version # Expected: openjdk version "1.8.0_XXX" (Zulu...)
Raspberry Pi OS (32-bit) — Pi 3 & older
# Update and install OpenJDK 8 (armhf build) sudo apt update sudo apt install -y openjdk-8-jdk # Verify java -version
✅ Raspberry Pi performance tips:
|
Running ORO POS on Linux
Once Java 8 is installed, running ORO POS is the same on all distributions:
# Navigate to the extracted ORO POS folder cd /path/to/oropos # Option A — run the JAR directly java -jar oropos.jar # Option B — use the shell script chmod +x oropos.sh ./oropos.sh
To run ORO POS as a background service (so it starts on boot), create a systemd unit file:
sudo nano /etc/systemd/system/oropos.service
[Unit] Description=ORO POS After=network.target [Service] User=pi WorkingDirectory=/home/pi/oropos ExecStart=/usr/bin/java -jar /home/pi/oropos/oropos.jar Restart=on-failure [Install] WantedBy=multi-user.target
sudo systemctl daemon-reload sudo systemctl enable oropos sudo systemctl start oropos
Verify your Java version
Before launching ORO POS, always confirm you are running Java 8:
java -version # Must show: openjdk version "1.8.0_XXX" or java version "1.8.0_XXX" # If it shows 11, 17, or 21 — follow the "set as default" steps above.
Have a question about your specific distro or hardware? Email helpdesk@orocube.net with your Linux version and the output of java -version and uname -a — we will help you get running.