Install and set up a till

Install the till

The till is one zip file per operating system. It holds everything it needs: there is no database or runtime to install.

1. Download the zip for your PC: from the Matjar website, or in Tadbir from Matjar › Overview › Download the till app.
2. Unzip it on the PC that will be the till. This PC must stay on while the shop is open.
3. Run the install script as an administrator, with the key Oloom gives you with the download.

Linux (x64 or ARM64):

sudo bash install.sh --mode standalone --oloom-public-key <key> --kiosk-user <login>

Windows (x64), in an administrator PowerShell:

powershell -ExecutionPolicy Bypass -File install.ps1 -Mode standalone -OloomPublicKey <key> -KioskUser <login>

The kiosk user is the person whose desktop session opens the till full screen. On Windows, that person must have signed in once before.

WARNING

The Windows installer has not been checked on a real till yet. Test it on your own PC before you rely on it.

After install, the till opens on the setup screen. On the till PC you can also open http://localhost:8090 in a browser. The setup has five steps: Language, Licence, Shop, Details and Owner.

Standalone till: activate it with a licence

1. On the Licence step, the till shows its Till code.
2. In Tadbir, sign in as Admin and open Admin → Billing → Your tills. Type the till code, the shop name and the country, then choose Activate this till. The licence file (.pack) downloads at once.
3. Copy the file to the till and load it with Choose a file. The till checks it and shows who it is for.
4. On the Shop step, choose the Country and the Business type, and answer Must your business use a certified till? See Fiscal rules by country before you answer: a till under the rules never leaves them.
5. On the Details step, fill in what prints on every receipt (business name, address, tax number), and whether your prices include tax.
6. On the Owner step, enter your name, check the date and time, and choose your PIN (4 to 8 digits).
7. The till shows a recovery code once only. Write it down and keep it safe: it resets the owner PIN if it is lost.

A licence for another till, or a changed file, is refused. You can download a licence again from the billing page at any time.

Then, in the owner area: add your printers, set up backups, and add your products.

Licence end and renewal

A licence lasts as long as your subscription period. After each renewal, download the new file from Admin → Billing → Your tills, and load it on the till in Owner › Account › Licence › Install a renewed licence. The current licence stays if the file is refused.

The till warns from 30 days before the end, then gives a grace period. After it, no new shift can open, but a shift already open finishes normally, and your records and exports stay available.

Connected till: pair it with Tadbir

In Tadbir (an Admin or Super Admin):

1. Open Matjar › Tills & shops. Add a shop first if you have none, then choose Add a till.
2. If every paid till is in use, choose Add a paid till. One more till is billed from that day.
3. Open the till and choose Create a pairing code. The code is shown once only and expires.

On the till:

1. On the setup screen, choose to connect the till to Tadbir.
2. Enter the Server address (https://…) and the Pairing code.
3. If the till shows a certificate fingerprint, compare it with the one Tadbir shows, then choose This is my server: send the code.
4. The till shows your shop name. Check it and choose Yes, connect.
5. The till loads your products and staff. Selling starts when the load is finished.

A wrong, used or expired code changes nothing: create a new one.

On a connected till, products, options, taxes and staff come from Tadbir and are read-only on the till. Change them in Tadbir.

Move a standalone till to connected mode

Open Owner › Account › Connection and enter the server address and a pairing code, as above. The till's sales history goes up first; then its products and staff come from Tadbir. Selling continues meanwhile.

Use the till day to day

• Tap Full screen on the lock screen or the selling screen.
• Every field opens an on-screen keyboard, so the till needs no physical keyboard.
• The till can be installed like an app from the browser menu (Install app or Add to Home screen).

Update the till

Install updates between two shifts, with the update pack Oloom publishes:

sudo /opt/tadbir-till/update.sh <pack.zip>     # Linux
update.ps1 <pack.zip>                          # Windows

A pack must be signed by Oloom and newer than the installed version. If the new version does not start, the old one comes back.

Replace a till

See Backups and replacing a till.