Back to POSR
Ahmed Ali

Creating first sale

Get from a fresh install to your first order — minimal setup, cache reload, and the Menu workflow.

Open the app

Open any modern browser and go to localhost:5173, or use the port where your Docker container is running (check your docker compose port mapping if it differs).

Sign in with PIN 5555. This account has the super admin role and can access all management modules needed for initial setup.

Set up essentials

Before you can take orders, create the minimum configuration in Manage:

  • Your first dish — add at least one menu item with a price so it appears on the order screen
  • A floor — define the dining area layout for table-based service
  • Tables — place tables on the floor so staff can open orders from the floor plan

These three pieces are enough to start a basic dine-in flow. You can add modifiers, categories, and more dishes later as you refine the menu.

Reload cache

POSR stores configuration locally in the browser for fast access during service. After creating dishes, floors, and tables, sync that data:

  1. Open Settings — the button in the bottom-left of the sidebar
  2. Press Reload cache to pull the latest data from the server into the browser

Repeat this step whenever you change menu items, floor layout, or other settings in Manage and need those updates on the order-taking screen.

Take orders

Go to Menu to start taking orders. Select a table on the floor plan (or use takeaway mode if configured), tap dishes to add them to the cart, and send the order to the kitchen when ready.

With only a dish, floor, and tables configured, you can walk through the core order flow end to end. Payment and checkout behavior depends on the payment types and tax rules you configure next.

Full setup

The steps above are enough for a first sale, but a production restaurant still needs additional configuration in Manage:

  • Payment types — cash, card, and any integrated gateways
  • Taxes — rates applied to orders and receipts
  • Discounts — percentage or fixed reductions for promotions
  • Staff roles, kitchen stations, printers, and other operational settings

Configure these as you go live. After each change in Manage, use Settings → Reload cache so the POS reflects the latest data.