Once you have downloaded and extracted ORO POS, follow the steps below for your operating system. The first launch takes a few extra minutes — ORO POS sets up its database and configuration files automatically before showing the login screen.
| ⚠ Important: Never open more than one instance of ORO POS at the same time. If you accidentally start a second instance, close all windows and relaunch once. |
🪟 Windows
Java 8 is bundled with the Windows version — no separate installation is needed.
- Open the extracted ORO POS folder.
- Double-click oropos.exe to launch.
- Wait for the login screen — first launch may take 2–3 minutes while the database initialises.
| ℹ Windows Firewall prompt: On first launch Windows may ask to allow ORO POS through the firewall. Click Allow Access — this is required for multi-terminal setups and license activation. |
🍎 macOS
Java 8 is not bundled on macOS. You must install it before launching ORO POS. See the dedicated guide for Java installation and macOS security warning steps:
→ Running ORO POS on macOS — Java Setup & Security Guide
Once Java 8 is installed, open Terminal and run:
cd /path/to/oropos java -jar oropos.jar
Or use the shell script:
chmod +x oropos.sh ./oropos.sh
🐧 Linux & Raspberry Pi
Java 8 is not bundled on Linux. Install it first using the commands for your distribution:
→ Running ORO POS on Linux & Raspberry Pi — Java Setup Guide
Once Java 8 is installed:
cd /path/to/oropos java -jar oropos.jar
What to expect on first launch
| What you see | What it means |
|---|---|
| Blank/loading screen for 1–3 minutes | Normal — database is being created for the first time |
| PIN entry screen | ORO POS is ready. Default admin PIN is 1111 |
| License / activation screen | Enter your email and PIN to activate. Contact helpdesk if you don't have one |
| Error: "port in use" or "address already bound" | Another instance is already running. Close all ORO POS windows and try again |
Having trouble launching? Email helpdesk@orocube.net with your OS version and the error message shown — we will get you running.