When you need it
Use the browser for everything except these, which a browser cannot do:
Everything else — appointments, notes, results, billing — is identical in a browser, and a browser is the right choice for staff who move between machines.
Which build to install
Three builds, one for each edition. Install only the one matching your workspace.
Each keeps its own session, its own settings and its own local queue, so two builds on one machine never interfere.
Install it
1
Download the installer for your platform
- Windows — an
.exeinstaller. It installs for the current user and lets you choose the folder. - macOS — a
.dmg(or a.zip), for both Intel and Apple silicon. - Linux — an
AppImageor a.deb.
2
Run it, and expect a warning
The builds are not code-signed yet, so Windows SmartScreen shows an “unknown publisher” warning. Choose More info → Run anyway. macOS may need you to open it from the Applications folder the first time.
3
Sign in, online, once
Sign in exactly as you would in a browser — same email, same password, same passkey or authenticator code. The first run must have a connection: the app has nothing cached yet, and offline it shows “Can’t reach ClinikEHR” with the note that the terminal needs to connect once to finish setting up.
4
Set the receipt printer, if this is a till
Print one receipt and check it comes out on the right printer at the right width. See Thermal printers.
Launching the app a second time focuses the window that is already open rather than starting another. One machine runs one till.
What the desktop app adds
- Silent receipt printing. Receipts go straight to the printer with no dialog and without taking focus off the till, including a scannable barcode of the sale number. Prescriptions, payment slips, lab and imaging orders and invoices print the same way.
- Serial and barcode hardware. Scanners and count-scanner cradles on a USB serial bridge are picked up without a port picker. See Barcode scanners and Stock counts.
- A durable, encrypted local queue. Sales and captured orders are stored in a file the app owns, outside the browser’s data, and the patient details in it are encrypted with a key held by the computer’s own secure key store (Windows, macOS Keychain, or the Linux keyring). Clearing browsing data, or the browser profile being wiped by IT, does not touch queued sales, and a copy of the file cannot be read on another machine or by another user.
- Automatic updates. The shell checks on launch and every few hours, and installs quietly when you quit. Nothing in the queue is affected.
- Screen-capture protection, on the Desktop and Diagnostics builds: the window renders black in screenshots, recordings and screen shares. Useful on a workstation showing patient data; it also means a screen share during a support call shows a black rectangle.
Signing out, shared computers and the offline queue
- Signing out clears the patient list. When you sign out, or are signed out automatically after being idle, the app removes the patient list it keeps for offline use and every item that has already synced. The next person to sign in starts with nothing of yours on screen or on disk.
- Unsent work is kept. Sales and orders you captured while offline and that have not reached the server yet are never cleared by signing out. They are the only copy, so they stay and send after the next sign-in.
- Each item is sent by the person who captured it. If a colleague signs in on the same computer first, your queued items wait; the bar shows 1 sale captured by another user is waiting. They send when that person signs in. Nothing is lost, rejected or sent under the wrong name. Items captured before this version have no owner and send under whoever signs in.
Kiosk mode and idle locking
Two options exist for machines nobody supervises. Both are set when the terminal is installed, not from inside the app — ask support to configure them.- Kiosk mode runs full-screen with no window controls. It is off by default, including on tills, because staff multitask and a window with no controls traps them. Turn it on only for a genuinely dedicated, customer-facing terminal.
- Idle lock signs the session out — properly, not just showing a lock screen — after a period with no keyboard or mouse activity. It is off by default on every build, because the workspace’s automatic logoff does that job.
Check it worked
- The app opens straight into your workspace, with no address bar.
- A test receipt prints on the correct printer without a print dialog.
- A scanned barcode drops into the till without you selecting a port.
- Unplug the network and the till keeps ringing up sales — see Working without internet.
If something goes wrong
Another user's items are waiting on this computer
Another user's items are waiting on this computer
They were captured by a colleague who is signed out. They send automatically when that person signs in on this computer; nobody else can send them. If that person has left the clinic, contact support with the provisional references.
The app asked me to sign in again after updating
The app asked me to sign in again after updating
Updating to this version changes how the app stores its sign-in cookie. If you are asked once to sign in again, nothing queued is lost.
Windows blocks the installer
Windows blocks the installer
The builds are unsigned. Choose More info → Run anyway. If your organisation blocks unsigned installers outright, ask support.
Can't reach ClinikEHR
Can't reach ClinikEHR
The terminal has never completed a run online, so there is nothing cached. Fix the connection and sign in once. Sales already saved on the device are safe and sync automatically.
Nothing prints, or the receipt comes out blank
Nothing prints, or the receipt comes out blank
Check the printer is installed in the operating system and selected as the receipt printer, and that the paper size matches the roll. See Thermal printers.
The scanner does nothing
The scanner does nothing
Confirm the cradle is on a USB serial adapter and plugged in before you open the scan screen. See Barcode scanners.
The macOS app never updates itself
The macOS app never updates itself
Unsigned macOS builds cannot self-update. Download and install the current version manually until signed builds are available. Windows updates itself fine.
Related
Working without internet
What the till keeps doing during an outage, and what waits.
Set up the till hardware
Pharmacy-specific setup for the POS terminal.