Single Terminal vs Client-Server: Choosing Your Floreant POS Setup

Share

🖥️ 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.

🔄 Using ORO POS?

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.

✓ How it works

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.

✓ How it works

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.
⚠️ Open the database port in the firewall

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
💡 Before switching

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?

📞 Contact Support

Visit our knowledge base at guide.orocube.com or contact support at helpdesk@orocube.net

Was this artical helpful?