Installation guide

Print or save as PDF

Devices

Which devices work with Ironloom POS?

Standard point-of-sale devices: barcode scanners, ESC/POS receipt printers, cash drawers opened through the printer, label printers, serial scales, customer displays and a stand-alone card terminal. You need none of them to start: the till works with a keyboard and a mouse alone.

The Hardware screen: one card per device.
The Hardware screen: one card per device.
Device How it connects
Barcode scanner USB (several at once), keyboard-style scanners, serial or Bluetooth, or a webcam
Receipt printer ESC/POS thermal printers, 58 or 80 mm, through their Windows driver, the network (port 9100) or a serial port
Cash drawer through the receipt printer’s drawer socket (the usual way), a serial port, or OPOS
Label printer ZPL or TSPL printers, or any printer with a Windows driver
Scale serial scales (CAS, Toledo and generic protocols) or OPOS; labels from labelling scales are read as barcodes
Customer display 2 × 20 pole displays, a second monitor, or OPOS
Card terminal a stand-alone terminal from your bank: the cashier types the amount on it

Before you buy

  • A printer described as “ESC/POS compatible” and a drawer that plugs into it are the safe choice.
  • The till has lists of common makes that fill in the usual settings; other makes that follow the same standards can be set up by hand.
  • Any Windows PC from Windows 7 SP1 to Windows 11 runs the program. A touch screen is optional.

Setting up

Open Hardware. Each device has its card with its settings and a Test button. Detect devices finds what is connected: see How do I let the till find and set up my devices?. Test hardware checks everything in one place: see How do I test all the devices of the till in one place?.

Settings are saved per till, so each till can have different devices.

Always run the test on your own device before the first day of sales. A make or model that is not in the lists may need its settings adjusted.

How do I let the till find and set up my devices?

Open Hardware and press Detect devices. The till looks for receipt and label printers, a second screen, point-of-sale devices on USB and, if you agree, a scale. It lists what it recognised with a tick box each; tick what to set up and confirm.

  1. Connect the devices, switch them on, and install the Windows driver of each printer first.
  2. Open Hardware and press Detect devices.
  3. The till searches and shows a wait message with a Cancel button. Stopping changes nothing.
  4. It asks whether to listen on the COM ports for a scale, for a few seconds. Put something on the scale if you answer yes.
  5. Under Suggestions, each device found has a tick box: a receipt printer with the cash drawer through it, a label printer, a customer display or second screen, a scale.
  6. Tick what you want and press Set up the ticked devices.
  7. Test each device from its card: see How do I test all the devices of the till in one place?.
  • Show the full detection report lists everything Windows reports: COM ports, printers, keyboard devices (USB scanners show here), webcams and screens.
  • Nothing new to set up. Printers need their Windows driver installed first; scales and pole displays need their COM port. means exactly that: install the driver, or check the cable.
  • A new till sets up a recognised receipt or label printer by itself at its first start.
  • A USB scanner that types like a keyboard needs no setup at all.

How do I set up a barcode scanner?

Plug in a USB scanner and scan: it works at once, on every screen, without setup. To make the till recognise the scanner as a scanner, so its scans never land in the wrong box, open Hardware, the Scanner card, and use Learn USB scanner (scan now).

The simple case: a USB scanner

Most scanners type the barcode like a very fast keyboard and end with Enter. The till recognises such fast typing as a scan on every screen and sends it to the right place: the sale, the Products search, the stock list.

Teach the till your scanner

  1. Open Hardware and the Scanner card.
  2. Press + Add scanner and choose the kind: USB, serial or Bluetooth, or webcam.
  3. For USB, press Learn USB scanner (scan now) and scan any barcode. The till remembers which device it came from.
  4. Press Test: scan something and scan again to check.
  5. Save.

A learned scanner is read directly, so what it sends never appears as typing in a text box, even when the cursor is somewhere else.

Other settings

  • Auto-detect scanners (learn from fast bursts): recognises unlearned scanners by their speed. Max ms between keys sets how fast “fast” is.
  • Tab suffix: for scanners that end with Tab in place of Enter.
  • Webcam index: which camera to use as a scanner. A webcam can read product barcodes too: hold the product still in front of the camera for a few seconds. It is slower than a barcode scanner, so use it as a backup or on a quiet till. Tilt a pack wrapped in plastic a little, so the light does not shine on the barcode. Test: scan something shows the camera picture and the code when it is read.
  • Brand / model: fills in usual settings for common makes.
  • Several scanners can be used on one till.

Problems: see The scanner does nothing, types into the wrong box, or scans the wrong product. What do I check? and, for Arabic keyboards, A barcode is not found when the keyboard is set to Arabic (or another language). Why?.

How do I set up the receipt printer?

Install the printer’s Windows driver, then open Hardware, the Printer card. Choose how it is connected, the paper width, and press Test. For a printer on the network, type its address and the port 9100.

  1. Install the printer in Windows with its driver, or connect it to the network.
  2. Open Hardware and the Printer card.
  3. Choose the Type:
  • Windows printer (Spooler): pick the printer from the list of Windows printers;
  • IP / host (Tcp) with the TCP port (usually 9100): for a network printer;
  • a serial port with its speed settings.
  1. Set Paper width (mm): 58 or 80 mm.
  2. Brand / model fills in the usual settings of common makes.
  3. Save and press Test. Check the paper: the text in the three languages is readable, the barcode and the QR code scan, and the paper is cut.

Arabic and other scripts

Leave Print Arabic as image (works on every printer) ticked: the till then draws Arabic text itself and sends it as a picture, so it prints correctly on printers without Arabic fonts. Code page (437 default, 864/1256 Arabic) matters only if you untick it.

More

How do I set up the cash drawer, and what is the drawer test?

Plug the drawer’s cable into the drawer socket of the receipt printer. The till opens it through the printer with a standard signal. If it stays closed, run Find the drawer setting: the till tries the common signals one by one and saves the one that opens your drawer.

Connect it

  1. Plug the drawer’s cable (a phone-style plug) into the socket marked for the drawer on the back of the receipt printer. Not into a phone or network socket.
  2. Set up the receipt printer first: see How do I set up the receipt printer?.
  3. Open Hardware and the Drawer card. The usual Type is the drawer through the printer.
  4. Press the test. If the drawer opens, you are done.

The drawer test

  1. Open Test hardware in Hardware and press Find the drawer setting.
  2. The till sends one signal and asks Did the drawer open?
  3. Answer Yes, or No to try the next signal, or Stop. There are eight candidates, a couple of seconds apart.
  4. On Yes, that setting is saved for this till.

A cashier can start the same test from the till: pressing Open drawer twice within 10 seconds offers it.

Settings by hand

Open command, Pin (0 = pin 2, 1 = pin 5), On time (x2 ms, default 25) and Off time (x2 ms, default 250) are the signal itself; your drawer’s leaflet may give them. The on time must be at most a quarter of the off time, or the drawer’s coil can overheat. A serial drawer and an OPOS drawer have their own kind. Drawer open when the sensor signal is high is for drawers that report whether they are open.

Who may open the drawer without a sale is set on the same card: see How do I decide who may open the cash drawer without a sale?.

How do I connect a scale to the till?

Connect the scale to a serial (COM) port of the PC, open Hardware, the Scale card, choose its kind and port, and press Test with something on the platter. A labelling scale that prints barcodes needs no connection: its labels are scanned.

A scale read by the till

  1. Connect the scale’s cable to a COM port, or to a USB-to-serial adapter.
  2. Open Hardware and the Scale card.
  3. Choose the Type: the protocol your scale speaks (CAS, Toledo, generic) or OPOS, and the port with its speed settings from the scale’s manual.
  4. Brand / model fills in usual settings for common makes. Detect devices can also find the scale by listening on the ports: see How do I let the till find and set up my devices?.
  5. Put something on the scale and press Test. The till shows the weight.

kg or lb

Scale reports in is used when the scale sends a weight without naming the unit: Automatic (store measurement system), kg or lb. Weights sent with kg, g, lb or oz are always read as sent.

Messages

No stable weight: the scale answered, but the weight was still moving or was zero. Wait until the scale is steady. No answer at all means the wrong port, speed or cable.

A labelling scale

A scale that prints its own price labels is not connected. Tell the till how its barcodes are built, once: see How do I make the till read the weight or price labels of my labelling scale, and set the containers for tare?.

Selling by weight is regulated in most countries: the scale must be an approved type and may need periodic verification. That is between the store and the local weights and measures office; the till only reads what the scale sends.

How do I set up a label printer for shelf labels?

Install the label printer’s Windows driver, open Hardware, the label card, choose the printer’s language (ZPL, TSPL or its Windows driver) and type the size of your labels in millimetres. Press Test to print one.

  1. Load the labels and install the printer in Windows.
  2. Open Hardware and the label printer card.
  3. Choose the Type: ZPL (Zebra and compatible), TSPL (TSC and compatible), or the Windows driver for other printers.
  4. Type Label width mm, Label height mm and Gap mm: measure one label and the space between two labels.
  5. Tick Print barcode and Print date as you wish.
  6. Brand / model fills in usual settings for common makes.
  7. Save and press Test.
  • If the print starts too high or too low, or creeps from label to label, the height or the gap is wrong. Many printers also have their own calibration button: see the printer’s leaflet.
  • A label shows the product name, the price, the SKU and the barcode; a weighed product shows its price per unit.
  • Labels are printed from Products: see How do I print shelf labels?.
  • The receipt printer cannot print adhesive shelf labels; the two printers are set up separately.

How do I set up a customer display?

Open Hardware, the Customer display card, and choose the kind: a pole display with two lines of 20 characters on a COM port, or a Second monitor connected to the PC. Press Test: it should show Ironloom POS and the time.

A pole display (2 × 20)

  1. Connect it to a COM port, or a USB port that Windows shows as a COM port.
  2. In the Customer display card choose the Type and the port.
  3. Choose the VFD command set your display understands: Epson, CD5220 or plain text. The leaflet of the display names it.
  4. Save and press Test.

If the test shows odd characters, try another command set, or check the port speed.

A second monitor

  1. Connect a second screen to the PC and set Windows to extend the desktop onto it.
  2. In the Customer display card choose Second monitor and the screen.
  3. Save and press Test.

What the customer sees

  • each product as it is added, with its price, and the running total;
  • at payment, the total and then the change, or a thank-you;
  • the price found with a price check.

The display follows the sale by itself: the cashier does nothing.

Does my card terminal connect to the till?

Not in the Standard edition. The till works with a stand-alone terminal: the one your bank or payment provider gave you, not wired to the PC. The cashier reads the amount on the till, types it on the terminal, and confirms on the till whether the card was approved.

How it works day to day

  1. The till shows the amount in large digits.
  2. The cashier types it on the terminal and the customer pays.
  3. The cashier presses approved or declined on the till: see How do I take a card payment?.
  4. At the end of the shift, the terminal’s total is compared with the till’s card total, which catches typing mistakes: see At closing the till asks for the card total. What do I type?.

In the Hardware screen

The Card card has a Type. Leave it on the stand-alone (manual) kind. The simulator kind approves every card after a second and is only for the demo: never use it in a real store.

Why it is not connected

Sending the amount to a terminal needs the bank’s or the provider’s own connection, which differs for every bank and country and needs an agreement with them. Integrated card terminals through payment providers are not part of this version.

What you need

Any card terminal with its own connection (network, Wi-Fi or mobile data) and its own paper or screen receipt. The contract, the fees and the settlement to your bank account are between you and the bank or provider. Ironloom POS never sees card numbers.

Installing, licence and updates

What do I need to run Ironloom POS?

A PC with Windows 7 Service Pack 1, 8.1, 10 or 11, 32-bit or 64-bit, with 2 GB of memory and 500 MB of free disk space. Internet is needed at the first start; after that the till sells without it. No special hardware is required to begin.

Need Detail
Windows 7 SP1, 8.1, 10 or 11; 32-bit and 64-bit both work
Memory and disk 2 GB of memory, 500 MB of free disk space, more as your sales history grows
Microsoft .NET Framework 4.8 Windows 10 and 11 normally have it; on older Windows the installer adds it
A Windows account that may install programs for the installation only; cashiers then use ordinary accounts
Internet at the first start, to begin the trial or activate a licence; later now and then: see Does Ironloom POS work without internet?
Screen any; the screens are checked down to 1024 × 768. A touch screen is optional

Not needed to start

A scanner, a receipt printer, a drawer: the till works with a keyboard and a mouse, and devices can be added later: see Which devices work with Ironloom POS?.

What it does not run on

Ironloom POS is a Windows program. It does not run on a Mac, an iPad, an Android tablet or in a web browser. A Windows tablet or an all-in-one touch PC works.

Good to know

How do I install Ironloom POS?

Download the installer from the Ironloom POS site, open it, choose the language, accept the licence agreement and click Install. It takes a few minutes. The program goes into Program Files; your data is kept apart in its own folder.

  1. Download the installer from the download page of the Ironloom POS site.
  2. Open the file. If Windows shows “Windows protected your PC”, click More info, then Run anyway. Check first that the file came from the Ironloom site.
  3. Choose the language of the installer: English, Arabic or French.
  4. Read and accept the licence agreement. It is shown in the language you chose.
  5. If Microsoft .NET Framework 4.8 is missing, the installer adds it. Windows may ask to restart; setup continues afterwards.
  6. Choose the options:
  • a desktop icon;
  • start Ironloom POS when Windows starts: useful on a PC that is only a till;
  • allow other tills to connect to this PC: tick it only on the PC that will be the master for other tills: see How do I use more than one till in the same store?.
  1. Click Install, then Finish.

After installing

Start Ironloom POS from the Start menu or the desktop icon. The first start opens the setup of your store: see What happens at the first start, and how do I set up my store?.

Good to know

  • The data folder is separate from the program, so updating or reinstalling does not touch your sales: see Where is my data kept, and who can see it?.
  • On Windows 7 the installer also switches on the secure connection settings (TLS 1.2) the program needs to reach the internet.
  • Install with a Windows account that may install programs. Daily use does not need such an account.

What happens at the first start, and how do I set up my store?

The first start opens a short setup: language, store details, type of business, currency and tax, the owner’s name and PIN, and whether to load a demo. It takes a few minutes, and everything can be changed later in Settings.

  1. Language: English, Arabic or French. The rest of the setup is in that language.
  2. Store: the store name, address, phone and email (required), and optionally the legal name, the tax number and the logo. They are printed on receipts.
  3. Type of business: shop or supermarket, café or restaurant, clothing or shoes. The till, the menus and the demo products follow it.
  4. Currency and tax: the main currency, an optional second currency with today’s exchange rate (fetched from the internet, or typed), your tax rate and whether your prices include it.
  5. Owner: your full name and a PIN of 4 to 8 digits, typed twice. The owner is the highest role and signs in as “owner” with this PIN. Keep it safe.
  6. Demo: choose whether to start with a demo store to practise, or with an empty store.
  7. Press Finish. The sign-in screen opens.

Good to know

Next steps for a real store

  1. Connect and test your devices: see How do I let the till find and set up my devices?.
  2. Add your products: see How do I add a product? and How do I add many products quickly by scanning them?.
  3. Add your staff: see How do I add a user?.
  4. Set up backups to a USB stick or another computer: see How do I back up my data, and how do I restore a backup?.
  5. Open a shift and make a first sale: see How do I make a sale, from the first product to the receipt?.

How does the free trial work?

The trial is free for 14 days and starts when the till first reaches Ironloom over the internet. It covers one master PC and one till in the same store. During it, “Trial copy” is shown on the screen and printed on every receipt. When it ends, selling stops until a licence is entered; all your data is kept.

  • Start: at the first start with internet. Without internet the till says Connect this computer to the internet once to start the free 14-day trial (or to activate your licence).
  • During the trial: everything works. A small box in the top bar shows the days left, and receipts carry the words TRIAL COPY.
  • Two computers: one master PC and one till. A third computer is told The trial allows one master PC and one till per store. Buy a licence to use more computers.
  • At the end: the till says The 14-day trial has ended. Buy a licence to continue selling; all your data is kept. Reports and exports still work, so nothing is lost and nothing is locked away.
  • After buying: enter the licence key and continue with the same store, products and sales: see How do I buy a licence and enter the licence key?.

Good to know

  • The trial is per store and per computer and cannot be started again by reinstalling.
  • The clock of the PC matters: if the date is moved back, the till asks you to correct it before going on.
  • Receipts printed during the trial are marked as trial copies. Start real trading on a licence.
  • If you practised with the demo, switch the demo off before real sales: see How do I remove the demo data and start with my own store (Demo ON / OFF)?.

How do I buy a licence and enter the licence key?

Open Settings, Licence. Buy a licence opens the Ironloom site in your browser to pay; when the payment is done, this computer gets its licence by itself. If you already have a key, choose Enter a licence key and type the key that starts with ILPOS-. The till needs the internet once for this.

Buy from the till

  1. Open Settings and the tile Licence.
  2. Choose Buy a licence.
  3. Choose the licence and how many computers will use it: the main PC and every till.
  4. The Ironloom site opens in your browser to pay. When the payment is done, this computer receives its licence by itself.

Enter a key you already have

  1. Open Settings, Licence, and choose Enter a licence key.
  2. Type the Licence key and confirm. Licence keys from Ironloom start with ILPOS- and need the internet once to activate. After that the till works offline.

Check and renew

  • The licence window shows the status, the date until which the licence is valid, the installation id and the last contact with Ironloom.
  • Add tills to the licence opens the Ironloom site to buy extra tills for this store’s licence. The licence covers the main PC and one till; every computer above that is an extra till.
  • Check with Ironloom now fetches the licence again, for example after buying more tills.
  • A licence is for a period. Before it ends the till reminds you; Renew the licence opens the site to pay for one more year, and the new date arrives by itself.
  • When a licence has expired the till says so and stops selling until it is renewed; the data stays.

Good to know

  • Each computer that runs Ironloom POS uses one seat of the licence. Users are not counted.
  • Current prices are on the Ironloom POS site. Plugins and themes are paid once and live on the same licence: see What are plugins?.
  • Keep the email with your key. If you lose it, write to support@ironloomtechnologies.com from the address you bought with.

How do I move Ironloom POS and its licence to another computer?

Back up on the old PC, remove the licence from it with Move the licence to another computer in Settings, Licence, install on the new PC, restore the backup and enter the key there. The licence then belongs to the new computer.

  1. On the old PC: close the shift, then make a backup to a USB stick: Settings, Backups, Back up now: see How do I back up my data, and how do I restore a backup?.
  2. Still on the old PC: open Settings, Licence, and choose Move the licence to another computer. The till asks Remove the licence from this computer? This till goes back to trial and the licence can be activated on another computer. Confirm. It needs the internet.
  3. On the new PC: install Ironloom POS: see How do I install Ironloom POS?. Go through the first-start setup with any values; the backup will replace them.
  4. Restore the backup: Settings, Backups, Restore. The program restarts with your store.
  5. Enter the licence key: Settings, Licence, Enter a licence key: see How do I buy a licence and enter the licence key?.
  6. Set up the devices on the new PC: hardware settings belong to each computer: see How do I let the till find and set up my devices?.

If the old PC is broken or stolen

You cannot remove the licence from a PC that no longer starts. Write to support@ironloomtechnologies.com with your key or the email you bought with; support frees the seat so you can activate on the new PC. Your data comes from your last backup: this is why the backup must not be on the till’s own disk.

Good to know

  • A licence is tied to the computer it was activated on. Changing major parts of a PC can look like another computer to the licence check; if the till then asks for a key again, contact support.
  • After moving, the old PC goes back to trial state and cannot sell.

Does Ironloom POS work without internet?

Yes. Selling, payments, returns, stock and reports run on the PC itself and need no internet. The till needs the internet once to start the trial or activate a licence, and then must reach Ironloom at least once every 30 days.

Works without internet

Everything in daily use: the Checkout, payments, receipts, returns, shifts and Z reports, products, stock, customers, promotions, reports, backups, and several tills in one store on the local network.

Needs the internet

What When
Starting the trial, activating or moving a licence once, at that moment
The licence check in the background when a connection exists; at least once every 30 days
Smart Scan lookups of unknown barcodes when you scan one; otherwise it waits: see What does Smart Scan do when there is no internet?
Daily market exchange rates once a day; the last rates stay in use
Emailed receipts and the daily email when sent
Updates and problem reports when you check or send
Buying a licence or a plugin at that moment
E-invoicing to a tax platform invoices wait and are sent later

The 30 days

If the till has not reached Ironloom for 30 days it says This till has not reached Ironloom for 30 days. Connect it to the internet to renew the licence check. and stops selling until it has been online once. A short connection is enough, for example through a phone’s hotspot.

Good to know

  • Your data is on your PC, not on Ironloom’s servers. Ironloom cannot see your sales and cannot restore them for you: keep your own backups: see How do I back up my data, and how do I restore a backup?.
  • A till in a place without any internet can be used, as long as it is brought online once every 30 days.

How do I use more than one till in the same store?

Choose one PC as the master. On it, set Multi-till sync to master with a shared secret. On each other till, set Multi-till sync to till and enter the master’s address and the same secret. Each till then sells on its own and exchanges data with the master over the store’s network.

The master

  1. Install Ironloom POS on the PC that will be the master, usually the back-office PC, with the option that allows other tills to connect ticked: see How do I install Ironloom POS?.
  2. Open Settings, Multi-till sync, and choose Master PC.
  3. Set the Master port (8787 unless you have a reason to change it) and a Shared secret: a long word only your tills know.
  4. Save.

Each till

  1. Install Ironloom POS on the till PC and go through the first-start setup.
  2. Open Settings, Multi-till sync, and choose Till.
  3. Type the master’s address in Master URL, for example http://192.168.1.10:8787/ironloom, and the same Shared secret.
  4. Press Test connection. It should answer Master reachable.
  5. Press Download catalogue from master to download the catalogue, customers, users and promotions from the master. Local copies on the till are overwritten.
  6. Save. The till now sells by itself, sends its sales to the master and picks up changes at the interval set in Sync every N seconds. Sync now does it at once.

Rules

  • All PCs must be on the same network, and the master must keep the same address: give it a fixed address in your router.
  • The licence covers the main PC and one till. Each computer above that needs an extra till on the licence: add them in Settings, Licence, Add tills to the licence, see How do I buy a licence and enter the licence key?.
  • A till keeps selling when the master is off or unreachable, and catches up later.
  • Make changes to products and prices on the master.
  • Back up the master every day; it holds the store.

If Test connection fails: check that both PCs are on the same network, that the address and port are right, that the secret is identical, and that the Windows firewall on the master allows the program.

How do I update Ironloom POS to a new version?

Open About. It shows your version and whether a newer one exists. Press Check for updates, then Install update: the till downloads the new version, checks it, closes, updates and starts again. Your data is kept.

  1. Close the shift and make a backup first: see How do I back up my data, and how do I restore a backup?.
  2. Open About in the menu. It shows the version in use and when updates were last checked.
  3. Press Check for updates.
  4. If a newer version exists, press Install update.
  5. The till downloads the installer, checks that the file is the genuine one, and asks Windows for permission to install. Allow it.
  6. The program closes, updates itself and starts again. If the licence agreement changed, it is shown for you to accept.

Good to know

  • The till looks for updates by itself once a day and tells you when one is available. Nothing is installed without you pressing the button.
  • Updating does not touch your data folder. Sales, products and settings stay: see Where is my data kept, and who can see it?.
  • With several tills, update the master and all tills the same day, outside opening hours. Tills on different versions may not be able to exchange data.
  • You can also update by hand: download the new installer from the Ironloom POS site and run it over the old version.
  • Each version’s changes are listed on the site, in plain words.

After an update, make one test sale and print a receipt before the store opens.

How do I remove Ironloom POS from a computer?

Use Windows: Settings, Apps, find Ironloom POS and uninstall. The program is removed; the data folder with your sales records is left in place on purpose. Move the licence off the PC first if you will use it elsewhere.

  1. If the licence will be used on another PC, remove it from this one first: Settings, Licence, Move the licence to another computer: see How do I move Ironloom POS and its licence to another computer?.
  2. Make a last backup and take it off the PC: see How do I back up my data, and how do I restore a backup?.
  3. Close Ironloom POS.
  4. In Windows, open Settings, Apps (or Control Panel, Programs), choose Ironloom POS and uninstall.

What stays

The data folder C:\ProgramData\IronloomPOS, with the database, the backups, the product pictures and the logs. It is kept so that an uninstall by mistake, or a reinstall, loses nothing.

To remove the data too

Only when you are sure you no longer need it, and after checking how long your country requires business records to be kept: delete the folder C:\ProgramData\IronloomPOS by hand.

Before giving away or selling the PC, delete that folder: it holds your sales and your customers’ details. Deleting a folder does not make it unrecoverable; for a PC that leaves your hands, wipe the disk with a tool made for that.

How do I bring my products and customers over from another point-of-sale program?

Export your data from the old program, then open Settings, Import from another system, choose the file and press Read and analyse. The till shows how each column will be imported before anything changes. A backup is made first.

The import window after a file has been analysed.
The import window after a file has been analysed.
  1. In the old program, export products, customers and suppliers. CSV or Excel is the safest choice.
  2. Open Settings and the tile Import from another system.
  3. Choose the Exported file and press Read and analyse.
  4. The till reads the file and says what it recognised. For each table, choose what it is (Products, Customers, Suppliers, Categories, or not imported), and check which column feeds each field. Sample values are shown.
  5. Adjust if needed:
  • Prices: if prices come out 100 times too large, choose the division by 100;
  • Numbers use a decimal comma (12,50);
  • Update products and customers that already exist (same barcode, item code or phone);
  • Import stock quantities as opening stock (new products);
  • Import customer balances and loyalty points (new customers).
  1. Press Preview, read the warnings (products without a price, repeated barcodes, rows without a name), then Import now.

What it reads

Supported: CSV, Excel (.xlsx, .xls), JSON, XML, SQLite databases, SQL dump files, dBase (.dbf), Access (.mdb, .accdb) and ZIP files with any of these. Recognised directly: Loyverse, Square, Shopify, Lightspeed Retail, Odoo, uniCenta oPOS.

If the columns are not recognised

Enter a one-time Ironloom key and press Analyse with Ironloom AI. Only the table names, column names and 5 sample rows per table are sent to Ironloom; your full data stays on this computer. A key covers one migration and is bought on the Ironloom POS site.

Good to know

  • The file is read on this computer. Nothing is sent anywhere unless you choose the Ironloom AI analysis in the next step.
  • A full backup is made before importing. To undo the import, restore that backup in Settings > Backups.
  • Sales history of the old program is not imported: keep the old program’s reports for your records.
  • After importing, check a few products at the till and a few customer balances before trading.

Where is my data kept, and who can see it?

On your own PC, in the folder C:\ProgramData\IronloomPOS: one database file, with folders for backups, product pictures and logs. Your sales, customers and stock are not on Ironloom’s servers, and Ironloom cannot see or restore them.

The folder

Inside C:\ProgramData\IronloomPOS What
the database file the whole store: products, stock, sales, customers, users, settings, the audit log
backups the automatic and manual backups, unless you chose another folder
images product pictures and logos
logs technical logs of the program, used when a problem is reported
exports, einvoices files the program wrote at your request

What leaves your PC

  • The licence check: the computer’s installation id, the id of the store (a random number made at setup), the edition and version.
  • With the trial: the owner’s name, email and phone you typed at setup.
  • Smart Scan: the barcode being looked up; and product facts and shelf prices for the shared product database: see What does my store share with the Ironloom product database?.
  • A problem report, when you send one: your description, technical logs and, if you tick it, a screenshot. The report shows what will be sent before you send it.
  • Emails, e-invoices and accounting files go where you send them, not to Ironloom.

Who can see it in the store

Anyone who can sign in sees what their role allows. Anyone with access to the Windows account and the folder could copy the database file: protect the PC with a Windows password and keep it physically safe.

Your part

Back up to another device every day: see How do I back up my data, and how do I restore a backup?. If the PC is lost and there is no backup elsewhere, the data is gone: Ironloom has no copy.