Setup guide, permissions and daily workflows
Read this before installing Kit POS Desktop on a till. It covers the exact role permissions needed to log in, how location, table and PIN settings behave, the selling flows your cashier can run offline, and how sales get back to Kit.
1. Requirements
Device
- Windows 10 or Windows 11, 64-bit. Kit POS Desktop ships a Windows installer only; the web till at pos.kit.africa runs on any other machine.
- 4 GB RAM minimum; 8 GB recommended for busy restaurants or multi-user tills.
- 500 MB free disk space plus room for offline sale history.
Network
- Internet is required for the first username or email login.
- After setup, selling continues offline and syncs when the connection returns.
- Keep the server URL pointed to
https://pos.kit.africafor production.
Printing
- Receipt and restaurant section token printing use the same Kit printing flow as the web POS.
- Install QZ Tray when using ESC/POS receipt printers.
- Under Token printers, choose a printer for every restaurant section configured in Kit.
2. Permissions required to log in
Assign these in Kit under User Management, Roles & Permissions. The same roles apply on the web, the phone apps and the till.
| Permission area | Permission | Why it is required |
|---|---|---|
| POS Desktop | Login on a new device (pos_desktop.login_new_device) | Lets the user register this till and pull the business data needed for offline use. |
| Products | View products (product.view) | Lets the desktop app show products, variations, prices, lots and stock. |
| Sell | Sell products (sell.create) | Lets the cashier create sales, quotations and suspended token orders. |
If any required permission is missing, Kit POS Desktop stops the login and shows User permissions are insufficient. Add the missing role permission, then sign in again.
3. First login: connect a business to the till
1. Install
- Download the installer from the Downloads page and run it.
- Open Kit POS Desktop and confirm the server is
https://pos.kit.africa. - Use a Kit username or email and password for the first login.
2. Choose a location
- If the user has more than one location, choose the till location.
- The app downloads products, customers, staff, settings, taxes and payment accounts.
- The logged-in user becomes the user shown in the sale's Added by.
3. Staff login mode
- If staff PINs are enabled, eligible staff can use the PIN pad after setup.
- If service staff PINs are disabled, those users do not get PIN pad access.
- If the business has no tables module, staff go straight to POS and sell directly.
4. Logging out (since 3.4.2)
The Open register window now has a Log out button. Use it to hand the till to another Kit user, or to sign out at the end of the day, without uninstalling or clearing the app.
- Logging out keeps the till's local data: products, settings and any sales still waiting to sync stay on the device and sync once the next user with the right permissions signs in and the connection is available.
- The next login needs the same three permissions above; staff PINs work again once a Kit user has opened the register.
- Since 3.4.2 the till is also quieter: health checks run on demand and background polls back off when the server is slow, so a weak connection does not slow the counter.
5. Daily selling workflows
Cash sale
- Open POS, add products, quantities and discounts.
- Choose cash or express checkout.
- Finalise. Fully paid sales sync to Kit as paid.
Credit sale
- Select or add the customer before checkout.
- Finalise with no payment or a partial payment.
- The due balance appears on the customer ledger after sync.
Quotation
- Add products in POS.
- Use the quotation action instead of a final sale.
- No stock is deducted until the quotation is converted to a sale.
Token or suspended sale
- Add items, and the table or waiter where enabled.
- Suspend the sale to create a token.
- Resume the token later and finalise payment.
Kit Pay mobile money
- Choose Kit Pay or mobile money in checkout.
- Enter the phone number and amount using the visible numpad.
- Confirm once the payment status succeeds.
Invoice numbering
Desktop sale invoice and order numbers use uppercase KOD-{login count}-{invoice no}, for example KOD-7-23, so a till's sales are easy to tell apart from web sales in reports.
6. Sync, deleted records and recovery
| Situation | What to do |
|---|---|
| Sales are pending | Keep selling. They remain queued locally and retry automatically when the server is reachable. The office can see each till's pending count in Kit. |
| A sale was deleted in Kit | Ask an admin to open Reports › Deleted Documents, restore the sale, then sync the desktop app. |
| A paid sale shows partial | Sync again and check the sale payment lines. Fully paid desktop sales should show as paid in Kit. |
| User attribution looks wrong | Log out and sign back in as the cashier who is selling. Desktop sales use that user as Added by. |
7. Updates
- The current release is 3.6.2 (stable, 13 November 2026), a Windows x64 installer of 298 MB. What changed in each version is on the release notes page.
- Install a new version over the existing one from the Downloads page; existing local data is retained. Sync any pending sales first if you can.
- Windows may ask for confirmation on first install of a new version. Release notes and older versions are on the release notes page.
8. Remote support (Kit Remote)
Since 3.5.1, Kit POS Desktop includes Kit Remote, Kit's remote support app, so that Kit support can help you on the till when you ask. The till gets a nine-digit Kit Remote ID, shown in Kit POS under Settings › Updates & About. Nobody on the till needs a Kit Remote account.
What is installed
- The Kit POS installer carries the Kit Remote installer, the same way it carries QZ Tray. When Kit POS is installed or updated and Kit Remote is missing or older than the version that Kit POS release carries, the Kit POS installer checks the Kit Remote installer against the SHA-256 fingerprint built into Kit POS and installs it silently, with no extra prompt. It never replaces a newer Kit Remote, and it leaves an upgrade for later while a support session is running. A Kit POS install or update never fails because of Kit Remote.
- Kit Remote adds the Kit Remote app and the Windows service KitRemoteHost, which stays connected to remote.kit.africa so that support requests can reach the till. The ID appears once the till is online.
- Kit Remote is installed only on computers with a 64-bit Intel or AMD (x64) processor. Kit POS never changes or turns off antivirus or other security software.
Approval at the till
- Nobody can see or control the till unless the person at the till approves the request in the Kit Remote prompt. The prompt shows the requester's name and organisation, and their photo or initials. Decline or block the request and nothing is shown.
- An approval lasts 30 minutes unless the person approving chooses a longer time (1 hour, 6 hours, a custom time of up to 365 days, or until they revoke it). Until it ends, the same person can reconnect without a new prompt, even when nobody is at the till, and an approval until they revoke it never ends by itself. After that, a new approval is needed.
- While someone is connected, a bar on the screen says so. Closing the bar ends the session at once.
How genuine Kit support appears
Kit support always shows Verified organisation: Kit POS Uganda Limited. Every Kit Remote prompt says so, and on a Windows till a request from Kit support shows Verified business: Kit POS Uganda Limited. Never approve a request you did not ask for. If in doubt, decline and call Kit support on +256 326 901 600.
Removing Kit Remote
- Uninstall Kit Remote in Windows Settings › Apps; Kit POS updates do not put it back.
- Uninstalling Kit POS Desktop leaves Kit Remote installed, as it leaves QZ Tray; uninstall Kit Remote separately in Settings › Apps. If Kit POS is installed again later, it installs Kit Remote again, unless Kit Remote was turned off with
/NOKITREMOTEor theKitRemotepolicy below, or was uninstalled while Kit POS was installed: Kit POS remembers both. - To have Kit Remote again, an administrator runs the Kit POS installer with
/KITREMOTE=on, or installs Kit Remote. - Kit Remote keeps the computer's identity in a folder only administrators can read, so a reinstall usually keeps the same ID, with its saved approvals and blocks. Kit Remote's privacy notice says how to delete it.
For IT administrators: turn it off
- Install Kit POS with
Kit-POS-Setup-<version>.exe/NOKITREMOTE(also with/S): Kit Remote is not installed, now or by later Kit POS updates./KITREMOTE=onundoes it. - Or set the policy
HKLM\, DWORDSOFTWARE\ Policies\ Kit\ Kit POS KitRemote=0, by Group Policy or in the registry. - Neither removes a Kit Remote that is already installed; uninstall it in Settings › Apps.
What Kit Remote sends and keeps is set out in the Kit privacy notice and in Kit Remote's privacy notice.
9. Troubleshooting
User permissions are insufficient
Add pos_desktop.login_new_device, product.view and sell.create to the user's role or override, then try again.
No tables screen
This is correct when the tables module is not enabled for the business. The app logs straight into POS and sells as takeaway or direct sales.
No PIN pad access
Confirm staff PINs are enabled and the user is allowed to use a PIN. Businesses with service staff PINs disabled do not show those staff on the PIN pad.
Still stuck?
WhatsApp or call +256 326 901 600 or email support@kit.africa with your business name and the app version shown in the Open register window.