Use on a phone or tablet
Open the app on your phone or tablet while your books stay on your PC: on the same Wi-Fi only, over an encrypted connection, with each device paired once using a QR code and the app's PIN.
Set a PIN, tick Use on phone or tablet in Settings → Privacy & Security, click Pair a phone or tablet and scan the QR code with the phone. The phone's browser warns once that the connection is "not private"; compare the security code, continue, type the PIN. Done: the phone opens the app. The PC must be on, with the app running, and both on the same Wi-Fi.
#Turn it on (on the PC)
- Set a PINA phone must type the app's PIN to pair, so it needs one: Settings → Privacy & Security → App lock → Turn on PIN lock. The phone card has a Set a PIN button that takes you there.
- Tick the switchIn the same tab, the Use on phone or tablet card: tick Use on phone or tablet.
- Windows asks about the firewallThe first time, Windows Security may ask whether to allow Node.js JavaScript Runtime (the engine the app runs on) on networks. Tick Private networks (your home or shop Wi-Fi), leave Public networks unticked, and click Allow. Windows may ask for an administrator password. Clicked Cancel? See Phones cannot connect.
It is off until you turn it on. Off, nothing on your network can reach the app, exactly as before.
#Pair a phone or tablet
- Show the QR codeOn the PC click Pair a phone or tablet. A QR code appears with the address in words, a pairing code, and this PC's security code (eight pairs of letters and digits).
- Scan itConnect the phone to the same Wi-Fi as the PC (not mobile data), open its camera and point it at the QR code, then tap the link. No camera app that reads QR codes? Type the address shown on the PC (it starts with
https://) in the phone's browser; the page then asks for the pairing code too. - The warning, onceThe browser says Your connection is not private (Chrome) or This Connection Is Not Private (Safari). This is expected; here is why. Tap Advanced → Proceed to ... (Chrome), or Show Details → visit this website (Safari).
- Compare the security codeThe phone's Pair this device page shows a security code. It must be exactly the one on the PC. If it is different, stop and close the page. The sure check is the browser's own: see how to check it fully.
- Type the PINThe app's PIN, and a name for the device if you like (it is shown on the PC). Tap Pair this device. The app opens on the phone and asks for the PIN, as on the PC.
Each QR code works once, for 10 minutes, so a photo of an old one is useless. Show a new QR code makes a fresh one (the old one stops working). Five wrong PINs in a row: wait 30 seconds, and show a new QR code.
Tip: in the phone's browser menu choose Add to Home screen to open the app like any other.
#Why the browser says "Your connection is not private"
Everything between the phone and the PC is encrypted (HTTPS), so nobody else on the Wi-Fi can read your invoices on the way. For that, the PC uses its own certificate, made by the app on your PC the first time you turn phone access on. Websites buy their certificates from companies the browsers know; yours is the PC's own, so the browser cannot check who made it and warns you. That is all the warning means here.
What protects you is the security code: it is the start of the certificate's fingerprint, and it is different on every PC. The same code on the PC and on the phone means the phone is talking to your PC.
The sure check is in the browser, not on the page: someone who took over your Wi-Fi could show a fake pairing page that copies the PC's code. On the phone, tap the warning sign or Not secure next to the address, open the certificate's details, and compare the start of its SHA-256 fingerprint with the security code on the PC. Do this at least on a Wi-Fi other people also use.
The warning comes back only if the certificate changes: after about two years (the app makes a new one by itself), or if the books' dataphone-access folder was deleted.
#See and remove paired devices
The card lists every paired device with when it was paired and last used. Remove cuts that device off at once; to use it again, pair it again. Remove a phone that is lost, sold or given away.
Unticking Use on phone or tablet cuts every phone off at once and closes the network connection; the devices stay in the list and work again when you tick it. Turning the PIN off turns phone access off too.
#What works on the phone
The whole app: invoices, quotes, clients, products and stock, payments, reports, GST returns. The PIN lock asks for the PIN when the app opens on the phone too. Not on a phone: the Control Panel (update, restart, remove the app, open folders), choosing a backup folder, and phone access itself. Those act on the PC, so they are done on the PC.
The phone shows the books that are on the PC: the PC must be on, with the app running, and the phone on the same Wi-Fi. Away from that Wi-Fi the app does not open on the phone; that is on purpose.
#Phones cannot connect
- Same Wi-Fi? The phone must be on the PC's Wi-Fi, not mobile data. A guest Wi-Fi often keeps devices apart: use the main one.
- Clicked Cancel on the firewall question? Open Windows Security → Firewall & network protection → Allow an app through firewall → Change settings. Find Node.js JavaScript Runtime (there may be two lines), tick Private on each, and click OK. This needs an administrator.
- Windows calls your Wi-Fi "Public"? Then the firewall blocks it. Settings → Network & internet → Wi-Fi → your network → Private network (only for your own home or shop Wi-Fi).
- The PC's address changed (the router gave it a new one after a restart): the old link or home-screen icon stops working. Click Pair a phone or tablet again and scan the new QR code. To keep the address the same, ask whoever set up your router to give the PC a fixed address.
- "Port 47443 is used by another program" on the card: another program uses that port. Close it, then untick and tick the switch.
- "This pairing link is not valid any more": the code was used, ran out (10 minutes), or a newer QR code was shown. Show a new QR code and scan it.
- The phone shows the pairing page again: the device was removed on the PC, or the browser's data was cleared. Pair it again.
#How it is kept safe
- Off by default. Until you tick the switch, the app listens on the PC itself only (
127.0.0.1), as it always did. - Your own network only. The app answers only addresses of a home or office network (
192.168.x.x,10.x.x.x,172.16-31.x.x) and refuses anything from the internet. Never forward its port (47443) on your router. - Encrypted. HTTPS with the PC's own certificate. Its private key stays in the books'
dataphone-accessfolder, is never sent anywhere, and is never put in a backup. - Paired devices only. A device without a pairing gets only the pairing page; the app and your data answer nobody else. Pairing needs a one-time code from the PC's screen (10 minutes, once) and the PIN, which the PC checks: five wrong tries and it waits 30 seconds, and the code is thrown away.
- A long random key per device, kept by the phone's browser where web pages cannot read it (an HttpOnly, Secure, SameSite=Strict cookie). The PC keeps only a fingerprint of it (a hash), so even its own files cannot be used to get in.
- Other websites cannot use it. Changes are accepted only from the app's own page, and only under the PC's own address or name (this stops "DNS rebinding" tricks by websites).
- You stay in charge. Remove a device, or untick the switch, and it is cut off at once. Changing or removing the PIN, the Control Panel and phone access itself work only on the PC.
- On a NAS, Docker hides the real address of each device, so there the pairing alone keeps others out: never forward the port on your router. Other web pages served by the same NAS address (its own admin pages, for example) count as the same site for the browser; use only ones you trust.
On a NAS with Docker, the same pairing is the only way in: see Install on a NAS.