Welcome to ORO POS! This step-by-step guide walks you through downloading, installing, activating, and running your first transaction. Whether you are evaluating the software or setting up a new store, follow the instructions below to get started in minutes.
Before You Begin
Make sure your system meets the minimum requirements, then download the full-featured Trial to get started.
Demo products are fully functional versions intended for first-time evaluation only. As per our fair use policy, demo licenses do not include warranty or support and must not be used in live production environments. Customers who have already purchased the product are not eligible for new demo licenses. If you need additional training licenses, please request them within 30 days of purchase.
Step 1 — Unzip the Download
Extract the downloaded ZIP file. Inside you will find the following components:
- ORO POS — The core Point of Sale application.
- Floor Plan — Visual table-layout plugin for dine-in restaurants.
- Inventory — Full-featured inventory management with recipe tracking.
- Customer — Home delivery, driver management, and loyalty points plugin.
Plugins are stored inside the plugins folder. If you do not need a specific plugin, simply delete it from that folder. Alternatively, launch ORO POS in Default mode to start without loading any plugins.
After extraction, your folder should look like this:
Step 2 — Launch ORO POS
Windows
Double-click oropos.exe to start the application. On the first launch, ORO POS will create its configuration files and set up the database — this may take a few minutes. Wait until you see the login screen before proceeding.
Do not launch multiple instances of ORO POS at the same time. If you accidentally start more than one, close all except one before continuing.
Mac or Linux
Open a terminal, navigate to the extracted folder, and run:
java -jar oropos.jar
Alternatively, give execute permission to the shell script and run ./oropos.sh.
Oracle JDK 8 is required. Some Linux distributions ship with OpenJDK, which may cause compatibility issues. Verify your Java version with java -version and ensure the installation folder has read-write permissions.
Step 3 — Activate Your License
ORO POS requires a valid license to operate. You can activate using any of the methods below.
Option A — Online Activation with PIN
- Check your email for a demo activation PIN. If you have not received one, request a PIN here.
- In ORO POS, enter your email address (lowercase) and the PIN.
- Click Activate. The application will connect to our licensing server and activate your copy.
- Your terminal must be online during activation. Ensure port 8080 is open in your firewall.
- Use a valid, permanent email address in lowercase. Fake or disposable emails may permanently lock your terminal license.
- After activating ORO POS, each plugin will also prompt for activation — use the same email and PIN.
- If you have not received a PIN within 24 hours, email helpdesk@orocube.net.
Option B — Offline Activation with License File
If your terminal does not have internet access, you can request a license file by emailing helpdesk@orocube.net. License files are named after the product and use the .lic extension. Place the file in the application directory and restart ORO POS.
For more activation methods (including purchase-order activation), visit the full activation guide.
Step 4 — Test with Sample Data
ORO POS ships with a built-in Derby database pre-loaded with a sample store and menu items so you can test immediately.
To start fresh, shut down ORO POS, delete the database/derby single folder, then relaunch. A new sample database will be created automatically.
4.1 — Log In to the Back Office
The default administrator PIN is:
1111
Enter this PIN on the login screen to access the Back Office, where you can configure your store, menu, and user permissions.
4.2 — Open the Store
- From the login screen, tap Clock In.
- Start a new Store Session.
4.3 — Assign a Cash Drawer
Before you can accept payments, you must assign a cash drawer to your terminal. Tap Assign Drawer and confirm.
4.4 — Make Your First Transaction
From the home screen, follow these steps to complete a test sale:
- Tap Take Out (or any order type) and enter your name and PIN.
- Add items to the order from the menu.
- Tap Send to send items to the kitchen.
- Tap Settle to complete the payment and close the order.
Congratulations — you have successfully installed and tested ORO POS!
Next Steps
Now that your installation is verified, here are the recommended next steps:
- Store Setup Wizard — Configure your own store, menu, and tax settings.
- Menu Programming — Create your menu groups, categories, and items.
- Recommended Hardware — Printers, cash drawers, and payment terminals that work with ORO POS.
- Multi-Terminal Setup — Connect multiple POS stations to a shared database.
Need help? Call us at 1 (800) 844-6603 or email helpdesk@orocube.net.