🖥️ Single Terminal vs Client-Server: Choosing Your Floreant POS Setup
Floreant POS can run on one computer by itself, or on several computers that share one central database. This page explains both setups so you can pick the right one before you install.
ORO POS uses the same idea, but newer versions install PostgreSQL and include a setup wizard. See Single Terminal vs Client-Server: Choosing Your ORO POS Setup.
1️⃣ Standalone Mode (Single Terminal)
Best for: Trying Floreant out, food trucks, small shops with a single register.
Floreant POS ships with an embedded Apache Derby database and sample menu items. The POS and its database live in the same folder on the same computer. Unzip, run, and log in. No network setup is needed.
- ✓ Zero configuration: works right after unzipping
- ✓ Only one PC needed
- ✗ Can’t be shared: an embedded database can’t be opened from another computer
2️⃣ Server Mode (Client-Server / Multi-Terminal)
Best for: Restaurants and stores with two or more registers that need to see the same orders, tables and reports.
One computer runs a database server. Every Floreant terminal, including the one on the server PC, connects to it over LAN or Wi-Fi using the server’s IP address and port.
Database server options
| Database | Good for | Notes |
|---|---|---|
| Apache Derby Server | Small stores (2–3 terminals) | Included with Floreant. Start it with database/derby-server/start-server.bat (Windows) or start-server.sh (Linux/Mac). Uses port 51527. |
| PostgreSQL 9.5 | Busy stores, many terminals | Recommended for multi-terminal setups. |
| MySQL 5.6 | Shops already using MySQL | Supported, but known to have more issues. |
Terminals can’t connect if the server’s firewall blocks the database port (51527 for Derby Server). LAN is more reliable than Wi-Fi in a busy restaurant.
🍔 Real-World Example: Joe’s Diner with 3 Registers
| Step | What Joe does |
|---|---|
| 1 | Picks the front-counter PC as the server and starts Derby Server on it. |
| 2 | Runs ipconfig on that PC and finds its IP address: 192.168.1.66. |
| 3 | On each of the 3 registers, opens the database configuration and enters: DB type Apache Derby Server, Server 192.168.1.66, DB name posdb, User app, Password sa. |
| 4 | Clicks Test Connection, saves, and restarts each register. |
| ✅ | An order taken at the bar register now shows up immediately at the front counter. |
🤔 Which Mode Should You Choose?
| Scenario | Recommended Setup |
|---|---|
| Trying out Floreant POS | Standalone (embedded Derby) |
| Single register / food truck | Standalone |
| 2–3 registers, light traffic | Server with Derby Server |
| Busy restaurant, many terminals | Server with PostgreSQL |
Shut down Floreant and back up the database folder before you change database settings or recreate the database.
🚀 Next Steps
| 📥 Installation Guide | 🗄️ Database Setup (detailed) | 🖥️ ORO POS Version |
📚 Need More Help?
Visit our knowledge base at guide.orocube.com or contact support at helpdesk@orocube.net
