Setting up a till at a shop

For Storefront's service team. One PC, one shop, about an hour. Work down the page and tick each line. Words in bold are what the screen says.

Written 12 October 2026, before the first shop. Three steps here have not yet been run on a real PC: printing on the TM-T20III over USB, the reset tool, and a MoMo sale on the fixed build. Run them once at the office before the first visit. The pictures of the first screen, the recovery code, the set-up page, backup, remote view, staff and the Settings menu are of the real app on a test till. The rest are of the app's practice build with its sample shop, Kofas Books.

Never

Never uninstall Storefront POS. Uninstalling wipes the till. To update, run the new installer over the old one.
Never ask for, watch or write down anyone's PIN, the owner's recovery code or the owner's remote view password. Look away while they type.
Never run the reset tool on a till that has taken a real sale.
Never put practice sales on a shop's till. Every sale on it is a real record for good.

At the office, before you leave

The PC has the newest installer on it. Settings ends with the version and build. Note them:
The PC is brand new inside. Run reset-till.cmd from the service USB stick (it needs reset-till.ps1 beside it), read what it lists, and type RESET. Open Storefront POS: the first screen must be Set up this till with Create owner account.
The receipt printer's Windows driver is installed, and Windows prints its own test page on it (Windows Settings, Printers & scanners).
You are carrying: the PC and charger, printer, USB cable, paper rolls, cash drawer and its cable, a USB drive that will stay in the PC for backups, the service USB stick, and a printed copy of this page.
Storefront's office knows you are going and will answer the phone for step 6.

The Settings menu open, ending with the version and build line — Settings. The last line is the version and the build.

Collect from the shop

Shop name exactly as it should print on receipts:
Address: Phone:
Owner's name: Owner's email, for the remote view:
Staff names, and whether each is a manager or a cashier.
Today's item list as a spreadsheet or CSV: name and selling price for every item, and where they have them category, SKU, barcode, cost, stock counted today and low-stock level.
Internet: the Wi-Fi name and password, or a network cable.

On site, in this order

1The PC

Plug in, join the internet, and check the PC's date and time are right.

2The printer

Plug it into power and the PC, load paper, and print a Windows test page again. If Windows cannot print on it, Storefront cannot either: fix that first.

3The owner

Open Storefront POS. The owner, not you, types Your name and Your PIN (4 to 6 digits) and selects Create owner account.

Write down your recovery code appears once. The owner writes it on paper and keeps it away from the till. It is the only way back in if they forget their PIN.
The owner ticks I have written it down, selects Continue to sign in, and signs in.

The first screen of a new till: Set up this till, with Your name, Your PIN and Create owner account — The first screen of a new till.

Write down your recovery code, with the code, a tick box and Continue to sign in — Shown once. The code is blurred here.

4Set up this till

The page lists what the till needs. Do each row until its edge is green.

Shop details: Enter details, type the name, address and phone, then Save shop details.
How this till sells: check it reads On its own. A new till starts that way. If it reads Through Loyverse, select Sell on its own.
Tax: already filled in. Read the rates out to the owner and confirm them.

The Shop details screen with name, address and phone — Shop details. All three are needed.

Items

Settings, Import items, Choose CSV file, and pick the shop's file.
Check Column matching and read What importing will do. The number of new items should match the shop's list.
Select the button that reads Import ... items into this till. A refused row stops the whole import and names the row: fix the file and import again.

The import review, showing rows read, new items, changed, unchanged and skipped, and the Import button — What importing will do. Nothing is written until the orange button.

Receipt printer

Receipt printer, Set up. Search for the model and pick it.
Connection: USB, through Windows. Printer in Windows: pick the printer. Select Look again if it is not listed.
Paper width: the loaded roll.
Select Print test page and look at the paper. Only then tick I checked the actual test page. Enable receipt and report delivery.
Tick Print after every sale, and Open the cash drawer on cash sales if a drawer is plugged into the printer. Then Save printer.

Backup

Settings, Backup, Second copy, Choose folder: a folder on the USB drive that stays in the PC.
Back up now, then read Last good backup.

The Receipt printer screen with USB, through Windows chosen and the Epson TM-T20III picked from Windows' printers — Receipt printer. The name under **Printer in Windows** is the one Windows gave the printer.

The foot of the Receipt printer screen: the test page tick box, Print test page and Save printer — The foot of the same screen on the real app.

The Backup screen: Last good backup, Back up now, and Second copy with Choose folder — Backup, after **Back up now**. The line naming this PC's own folder is hidden here.

5Staff

Settings, Manage staff, Add staff for each person: their name and whether they are a cashier or a manager.
Each person types their own PIN. Look away.

Add staff, with name, role and PIN — Add staff, in Manage staff.

Manage staff on a new till: the owner, the recovery code and Add staff — Manage staff on a new till.

6Remote view

Phone Storefront's office with the shop name exactly as typed in step 4, and the owner's email. The office gives you a link code and sends the owner a sign-in link.

With the owner signed in on the till: Settings, Remote view. Service address: https://tills.rhstores.app
Type the Link code, then Link this till. Wait for Everything has been sent. A large item list takes a few minutes.
On the owner's phone: open the sign-in link, choose a password, and add the page to the Home Screen.
The page shows the shop's name and its stock.

Remote view with the service address typed in and the link code box empty — Remote view on the till. The code works once.

The owner's phone: choosing a password from the sign-in link — The owner's link: choose a password.

The owner's phone: today's takings, shift and sales — The owner's page, once the till has sent.

7Prove it with real sales

These stay on the record, so take real money for them.

Open the shift: count the drawer and type the opening float.
Sell one cheap item for cash. The receipt prints, the drawer opens, the change is right.
Sell one cheap item by MoMo: the MoMo tab, then MoMo received · Complete sale. Sale complete appears and the receipt prints, with Paid: MoMo.
Both sales are on the owner's phone within about a minute.
Out-of-stock tiles are faded and cannot be sold.

Three item tiles, the first faded and marked Out of stock — An out-of-stock tile beside two that can be sold.

Open the shift, with the opening float typed in — Open the shift. Enter 0 for an empty drawer.

Take payment, on the MoMo tab, with the MoMo received button — Take payment, MoMo tab.

A receipt for a MoMo sale, showing Paid: MoMo — The receipt of a MoMo sale.

8Hand over

The owner has: the recovery code on paper, their PIN in their head, the remote view on their phone, and Storefront's support number.
Staff have been shown: sign in, open a shift, a cash sale, a MoMo sale, close the shift.
Leave the backup USB drive plugged in. Bring this page, filled in, back to the office.

If something goes wrong

The printer is not in the list.: Its Windows driver is not installed, or it is unplugged. Fix that in Windows, then Look again.
The link code is refused.: A code works once and for 72 hours. Ask the office for a new one.
Windows warns about the installer ("Windows protected your PC").: Select More info, then Run anyway. Only for a file that came from Storefront's office.
Something was set up wrongly and no real sale has been taken.: Run the reset tool and start again from step 3. Tell the office, so the shop on the remote view is removed too.
Anything else.: Stop, leave the till as it is, and phone the office.