Free trial

Support that answers.

Runbooks for the problems tills actually have, every common answer, and a person on the other end of the email.

Reply time
1 business day (SAST)
Email
hello@kyledev.site
Runbooks
6
Answers
19

Symptom, cause, fix.

  1. RB-01

    The app says it cannot reach Kontrol at start

    On launch the app waits up to 20 seconds for the Kontrol service. It tells you whether this PC has no connection or the service reported a problem.

    1. 1Check the PC's internet connection.
    2. 2Close and reopen Kontrol.
    3. 3If it persists, email support with the time it happened.

  2. RB-02

    Sales taken offline are not in the back office yet

    Offline sales wait on the till and replay automatically on reconnect, on app start, and after the next online sale.

    1. 1Confirm the till is back online.
    2. 2Ring up the next sale or restart the till app to trigger a replay.
    3. 3Do not clear the till's browser data while sales are queued.

  3. RB-03

    A receipt printer does not appear

    The till lists printers already installed in Windows; it does not install drivers itself.

    1. 1Install the printer's driver in Windows first.
    2. 2Reopen the till panel so it re-reads the printer list.
    3. 3Use the till's shortcut to Windows printer settings to add the device.

  4. RB-04

    The cash drawer does not open

    The drawer opens on an ESC/POS pulse sent over COM or serial, a network printer on port 9100, or the printer driver.

    1. 1Pick the connection that matches how the drawer is cabled.
    2. 2For COM, choose the port the drawer or its printer uses.
    3. 3Test from the till panel before the shift starts.

  5. RB-05

    Scanning types into the wrong field

    Scanners act as keyboards. The till treats a burst of 4 or more characters under 30 ms apart, ending in Enter, as a scan.

    1. 1Keep the till window focused while scanning.
    2. 2Set the scanner to send Enter after each code.
    3. 3No scanner driver is needed; remove vendor keyboard software if it adds delays.

  6. RB-06

    Windows SmartScreen blocks the installer

    The installer is not code-signed yet.

    1. 1Verify the SHA-256 checksum on the Security page.
    2. 2Choose More info, then Run anyway.

Asked before, answered once.

Install and run

What does Kontrol need to run?
Windows 10 or 11, 64-bit, with 4GB of RAM. There is no server or database to install: the app connects to the Kontrol service over HTTPS. Businesses with a counter can also run a browser till on any current browser.
Is there a web login?
Not on this site. Kontrol is a Windows app: download it, install it, and sign in to your business inside the app.
Why does Windows show a SmartScreen warning?
The installer is not code-signed yet. Choose More info, then Run anyway. Check the SHA-256 checksum first so you know the file is the one we published.
How do I verify the installer?
Every release ships a SHA256SUMS.txt. On Windows run certutil -hashfile <file> SHA256 and compare the result with the published value.
How do updates arrive?
The app checks for a new version 15 seconds after launch and then every 4 hours. Downloads show progress, and release notes appear in What's New.
Does it run on macOS or Linux?
Native builds are in development. Until then the browser version works on both.

Counter sales (optional)

Do I have to use the till?
No. Counter sales are an optional module. Wholesalers, contractors, manufacturers and security companies leave it off and use the rest of Kontrol.
How do I put a till on another counter?
Open Deploy Satellite POS in the back office, choose a Windows or browser till, and hold Deploy. Kontrol confirms the installer exists, verifies its checksum, and gives you instructions to copy, email or share to the new device.
Does it keep selling when the internet drops?
Yes. Sales taken offline are queued on the till and replayed automatically when the connection returns: on reconnect, on app start, and after the next online sale. The till PC itself still needs power, so run it on a UPS during load shedding.
Which hardware works?
Receipt printers already installed on the PC appear in the till panel for silent printing. Cash drawers open over COM, a network printer or driver passthrough. Barcode scanners work immediately because they install as keyboards.
Which payments can a till take?
Cash with change calculation, card, and split payments across cash and card. Refunds put stock straight back on the shelf.

Data and security

Where is my data stored?
In one Postgres database. Every row carries your organisation's id and every query is scoped to the organisation you are signed in to, so one business can never read another's records. Queued offline sales sit in the till's local storage until they sync.
How are till PINs protected?
Only a hash is stored: scrypt with a random 16-byte salt per credential, checked in constant time. A PIN unlocks a till that already has a signed-in session; it is never the only credential. Each user gets 5 unlock attempts per minute, and repeated failures raise a security alert.
Who can do what?
9 roles (owner, administrator, operations manager, cashier, stock controller, procurement officer, accountant, marketing, field operative) map onto 51 permissions, enforced on every API request. Only owners and administrators can deploy tills.
Can I run more than one business?
Yes. One login can belong to several businesses and switch between them from the sidebar. Their data stays separate.

Plans and support

What does it cost?
From R299 a month on Starter to R1 299 on Professional, excluding 15% VAT. Enterprise is priced per operation. Every plan starts with a 30 day trial.
What happens when the trial ends?
The workspace locks until a plan is active.
Is it built for South African tax?
Prices are in rand, sales carry 15% VAT, and Finance produces a VAT summary for filing.
How fast does support reply?
Within one business day, South African time, from the people who wrote the software. Email hello@kyledev.site.

Still stuck?

Tell us what the till or back office is doing and when it started. You will hear back within one business day.

Contact support