Skip to content
FMX EPOS
Download
Help Centre home

Complete first-run setup

First-run setup has four stages: Database, Shop, Accounts and Licence. A new, empty database goes through all four. When this terminal joins another till or connects to an existing FMX EPOS database, the shop details and staff accounts are already there, so setup shows only Database and Licence.

Shortcuts and starting with Windows are not part of setup. The installer’s finish page sets them (see Install FMX EPOS), and you can change them later on the Windows card in Back Office → Local Settings → This Terminal.

Setup opens with a Welcome page on the main screen and, if the PC has another screen, on that screen too. It has a link and a QR code for the Quick Start guide under Before You Start.

  • With one screen, select Start Setup.
  • With two screens, go to the screen you want to use as the till and select Start Setup on This Screen there. The other screen then shows Standby until setup is complete.

The screen you start on becomes the till, and the other screen becomes the customer display. When setup finishes, FMX EPOS puts each window on its screen. You can change the screen roles later in Back Office → Local Settings → Screens.

To leave setup, select Exit at the top right. FMX EPOS asks “Exit now? Unsaved entries will be lost. Changes already applied are kept.” Confirm to close FMX EPOS, and start it again to carry on. Back returns to the previous stage.

1. Choose where the restaurant database lives

Section titled “1. Choose where the restaurant database lives”

The Database stage opens on Guided Setup, which asks how the shop is arranged and sets up the database for you. Expert Setup is the connection form, for when you already know the database details.

Whichever you use, tick I agree to the Terms and Conditions and the Privacy Policy on the first page of the Database stage. Continue stays unavailable until it is ticked and the question on the page is answered.

Illustration, not a screenshot. The real screen can differ with the theme or version.

Under How many tills will this shop use?, choose:

  • One Till: the shop’s data stays on this PC, in a Local SQLite database. Choose this when only this PC runs FMX EPOS. Screens plugged into it do not count. Select Continue. For backups, and for a local database that setup cannot use, see Local SQLite below.
  • Several Tills: the tills share one database on the shop’s network. A second PC running FMX EPOS counts, even if it only shows a host stand or kitchen screen. Setup then asks Is this the first till?:
    • First Till: this PC holds the shop’s database, or connects to the shop’s database server.
    • Join Another Till: this PC uses the database of a till that is already set up.

Under Does the shop already have a database server?, choose:

  • Yes: choose its Database Type (MySQL 8.4 or SQL Server), enter its details as described for SQL Server or MySQL below, and select Continue.
  • No or Not Sure: setup first checks this PC for MySQL, on the MySQL on This PC page.
    • If MySQL is already installed, enter its root password in MySQL Root Password and select Prepare Database.
    • If it is not, select Install MySQL. FMX EPOS downloads MySQL 8.4 (about 270 MB, so this PC needs an internet connection) and installs it in this till’s folder, with the Microsoft Visual C++ runtime if the PC does not have it. A progress bar shows each step. Leave setup running until it finishes.
    • If an earlier installation by FMX EPOS did not finish, setup says so. Select Prepare Database to start that MySQL service and create the shop’s database.
    • If an earlier MySQL install left databases in this till’s folder, choose Use These Databases to put MySQL back onto them with the shop’s data, or Start Again to keep them aside, renamed with the date and time, and start with new ones. After Use These Databases, other tills that used them may need to join this one again.
    • If the MySQL server already holds the shop’s database, setup tells you to choose Join Another Till instead and use a pairing code from a till that connects to it.

Installing or preparing MySQL needs a 64-bit Windows PC. Windows asks for permission before MySQL is set up: select Yes, or enter an administrator’s name and password. On 32-bit Windows, make another PC the first till or use an existing database server.

When FMX EPOS installs or prepares MySQL, it creates the shop’s database and opens Windows Firewall on private and domain networks only, so that the other tills can reach the database and find this till. If FMX EPOS installed MySQL, administrators can see the root password it generated in Back Office → Database.

Illustration, not a screenshot. The real screen can differ with the theme or version.

Next, Database Ready lists this PC’s addresses, which the other tills use to join it. An address marked set automatically (DHCP) can change, and if it does, the other tills and phones lose their connection to it. Give this PC a fixed IP address: reserve its address in the router’s DHCP settings, or set it in Windows. Select Continue to go on to the shop details.

  1. Choose Join Another Till. Setup lists the tills it finds on the network, with their address and version. A till that already shows a pairing code says waiting for a pairing code. Choose one, or type its address in Till Address. Select Search Again to look again. If no till answers, enter the address yourself. Each till shows its address in Back Office → Database → Add a Terminal.
  2. Select Find Till. Setup checks the till and shows its name and version. If the version differs from this PC’s, install the same version on both before they share a database.
  3. On the other till, open Back Office → Database → Add a Terminal and select Generate Pairing Code. It shows the code, that PC’s addresses and how long the code has left. See Database and maintenance.
  4. Enter the eight-character code in Pairing Code and select Join Till. The code works once and is valid for 10 minutes.
  5. This PC connects to the shop’s database, and setup goes on to Licence.

Illustration, not a screenshot. The real screen can differ with the theme or version.

If joining fails, setup says why:

Message What to do
“No FMX EPOS till answered at …” Check the address, and that FMX EPOS is running on that till and both PCs are on the same private network.
“That till has no pairing code open.” Generate a code on that till under Back Office → Database → Add a Terminal.
“The pairing code is wrong.” Check the code on the other till and enter it again.
“This pairing code has expired or was revoked.” Generate a new code on the other till.
“Too many wrong codes: this pairing code is revoked.” Five wrong attempts cancel the code. Generate a new one.

A till that keeps its data on Local SQLite cannot share it, and setup says so. On that till, open Back Office → Database → Add a Terminal. From there you can install MySQL on that PC, or prepare one already there, and then move the data with Data Migration. You can also move its data to an existing database server with Data Migration. Then join it again.

Illustration, not a screenshot. The real screen can differ with the theme or version.

In Database Type, choose Local SQLite, SQL Server or MySQL 8.4, then follow the steps for that type below.

Choose Local SQLite for a single till that keeps the restaurant database on its own computer.

It is the simplest option when you have one till. Staff phones and tablets can still take orders through that till with browser or Android staff ordering, but a second full till cannot share its database.

  1. Select Local SQLite in Database Type.
  2. Select Continue. FMX EPOS creates the database.
  3. Back up the restaurant’s data regularly. The safest way is to turn on Automatic Backup in Back Office → Database, or to export the data from the same page. If you copy the whole installation folder instead, close FMX EPOS first: the database changes all the time while FMX EPOS is running, and a copy taken then may not restore.

If setup finds a local database it cannot use, it offers Keep Old File & Create New Database. Use it only if you mean to start again with an empty database. The old file is kept beside the new one, renamed with the date and time, and none of its data is carried over.

Choose SQL Server when several tills must share one restaurant database, or when the business already runs a managed SQL Server. Select it in Database Type and select Continue. The connection page opens.

  1. Enter the server name or address in Server.
  2. Enter an Instance name only if your database administrator gave you one.
  3. Enter the Port. The usual default is 1433. With an instance name, you can leave Port blank so that SQL Server Browser finds it.
  4. Enter the Database name, Username and Password.
  5. Trust server certificate is ticked by default. Untick it only if the database administrator wants the server’s certificate checked.
  6. Select Continue. FMX EPOS tests the connection and prepares an empty database for FMX EPOS.

Choose MySQL 8.4 when the restaurant uses a supported MySQL server. Select it in Database Type and select Continue. The connection page opens.

  1. Enter the server name or address in Server.
  2. Enter the Port. The usual default is 3306.
  3. Enter the Database name, Username and Password.
  4. Keep Encrypt ticked when the server supports encrypted connections. Ask the database administrator before turning it off.
  5. Select Continue. FMX EPOS tests the connection and prepares an empty database for FMX EPOS.

Illustration, not a screenshot. The real screen can differ with the theme or version.

For a new installation, use an empty database with either option. If the database already holds a shop, setup asks This Database Already Has a Shop and names it. Join This Shop connects this till to that shop without changing anything in it, and goes on to Licence. Choose Another Database takes you back, so that you can enter the name of an empty database.

Illustration, not a screenshot. The real screen can differ with the theme or version.

If the connection fails, setup says why, for example a refused login, a server that does not answer or a database that does not exist. Check the server address, port, database name and login, then make sure the database server and its firewall accept connections from this till. FMX EPOS never switches to a local database on its own when a remote connection fails.

When tills will share a database (Several Tills in Guided Setup, or SQL Server or MySQL 8.4 in Expert Setup), setup shows the network this PC is on and how Windows treats it, for example “Network: Shop WiFi (Private).”

Other tills can reach this PC only on a network that Windows treats as Private (or a work domain). If Windows treats the network as Public, setup warns you. If it is the shop’s own network, select Make It Private and answer Windows’ prompt. Setup checks the network again by itself. To do it by hand:

  1. Select Open Network Settings.
  2. Choose Wi-Fi or Ethernet, then the network’s properties, and set it to Private network.
  3. Return to setup and select Check Again.

Illustration, not a screenshot. The real screen can differ with the theme or version.

When FMX EPOS is not running with Windows administrator rights, setup also notes that other devices reach this till on ports 5139 and 5140, which the FMX EPOS installer allows through Windows Firewall. If a device cannot connect later, run the installer again and choose Repair.

For a new database:

  1. Enter the Shop Name (up to 40 characters).

  2. Enter the Telephone number.

  3. Enter the Address shown on receipts and customer material.

  4. Under Menu and Orders, choose what to Start With:

    • An Empty Shop;
    • Takeaway Sample Data: a pizza, burger and chicken menu with options, kitchen screens, delivery fees, customers, coupons, a membership tier, customer display images and a 10p bag charge that is added by itself to collection and delivery orders;
    • Restaurant Sample Data: a menu in three courses, 27 tables in five areas, kitchen and bar screens, a 12.5% service charge that staff can offer, tip choices of 10%, 12.5% and 15%, coupons, a membership tier and customer display images. Restaurant mode is on, and the till opens on the tables.

    The sample is fictional and has no orders. Before trading, edit or remove it in Back Office, including the charges, delivery fees, coupons and membership tier it adds.

  5. Select Continue to go to the Accounts stage.

The shop name, address and telephone are required. If one is missing, setup says “Enter the shop name, address and telephone number.” Back returns to the previous stage.

Illustration, not a screenshot. The real screen can differ with the theme or version.

You can change these details later in Back Office → System Settings → Shop Details. Once the store is connected to FMX EPOS Cloud, you can also change some shop details from Cloud, and the till applies those changes.

For a new database, create both of these accounts:

  1. Under Administrator, enter a Username, a Password of at least four characters and the same password again in Confirm Password. If the two differ, setup says “The passwords do not match.”
  2. Under First Cashier, enter the Name and a four-digit PIN. This cashier is a Manager: they can approve other cashiers’ actions with their PIN.
  3. Select Continue.

Illustration, not a screenshot. The real screen can differ with the theme or version.

If the sample data cannot be added, setup says The shop is set up, but the sample data could not be added with the reason, above the Licence stage. The shop and both accounts are saved, so carry on.

The administrator signs in with a username and password, and the cashier uses a PIN. Do not hand out the administrator password for everyday till use. You can change the PIN length for all cashiers later in Back Office → Users → PIN Length. See Sign in and understand roles.

Saving the accounts also:

  • adds two VAT rates, Zero rate (0%) and Standard rate (20%), which you can change under Back Office → Menus → VAT Rates;
  • makes this computer the restaurant’s Integration Host: the till that takes in delivery platform, website and QR orders and makes the automatic backup. You can move this role to another terminal later in Back Office → Online Platforms. See Local, remote and Cloud operation.

Under How will this till be licensed?, choose one and select Continue:

  • I Already Have an Offline Licence: paste the code into Licence Code and select Enter Licence Code, or select Find My Licence to look for one issued to this computer.
  • I Already Have a Cloud Account: setup shows a pairing code, a QR code and an address. Scan the code with your phone or open the address, and sign in to add this shop to your account.
  • Try Offline Licensing: a free trial on this computer, once per computer. Select Start Free Trial.
  • Try Cloud: setup shows a pairing code, a QR code and an address. Scan the code with your phone or open the address, create your account and confirm your email address.

With either cloud choice the screen updates by itself once the shop is claimed. If the code expires, setup says so: select Get a Code for another. If the shop is claimed but cannot use cloud licensing yet, setup says why, and you can choose another way.

Illustration, not a screenshot. The real screen can differ with the theme or version.

Set Up Later skips this stage. A till starts no sales until it is licensed; you can do this later in Back Office → Licence.

The choices depend on this computer, the shop and any licence it already has. A virtual machine offers the cloud choices only. A terminal joining a shop on offline licensing is offered the offline choices, with Try Offline Licensing only if this computer has no offline licence in date. A virtual machine joining such a shop gets no choice: an administrator must switch the shop to cloud licensing in Back Office → Licence. A terminal joining a shop on cloud licensing needs no choice: it takes a till seat by itself once one is free, and a kitchen screen or host stand takes none.

The last page says which licence this till has. For a new shop, select Sign In to Back Office. For a terminal that joined a shop, select Continue to Sign In.

Sign in with the administrator username and password. A new shop’s Back Office opens on the Setup Guide; see After setup. For everyday till work, select Till Sign In and enter the cashier PIN. The till signs in as soon as the fourth digit is entered.

Connecting another terminal to an existing database

Section titled “Connecting another terminal to an existing database”
  1. Install FMX EPOS on the new computer.
  2. At the Database stage, the easiest way is Guided Setup. Choose Several Tills, then Join Another Till, and pair this PC with a till that already uses the shop’s database, as described above. If you have the connection details, you can use Expert Setup instead. Choose the type the restaurant uses (SQL Server or MySQL 8.4), enter the existing database’s connection details, select Continue, then Join This Shop.
  3. Choose how this terminal is licensed, then sign in with an existing account.
  4. On a terminal that joined a shop on a database server, the Overview shows Set Up This Terminal. Select it to check this computer’s card machine, printers and screens, then select Finish Terminal Setup.

Each terminal keeps its own local settings, and each computer runs one till. With a store-wide Cloud licence, each running till also needs a free till seat. A kitchen-only terminal does not use a till seat. To make a terminal kitchen-only, tick Kitchen-Only Terminal under Back Office → Local Settings → This Terminal and select Save Terminal Settings.

The quickest way through the rest is the setup guide, which opens after a new shop’s first Back Office sign-in. To come back to it, select Continue Setup Guide on Overview, or open Back Office → Setup Guide. It covers the licence, how you trade, the shop and its charges, the menu, tables and the kitchen, payments and this terminal, staff, and online services, one task at a time and in any order. See Use the setup guide.

Before you start trading, check these whether or not you used the guide:

  1. Open Back Office → System Settings and check Shop Details (including the VAT number), the till branding and the customer display. Receipt layouts are in Back Office → Print Design.
  2. On each terminal, open Back Office → Local Settings and set up its screens, printers and security switches. Remote access from other devices is off on a new installation and can be turned on only in the desktop app on that till. See Security and network access.
  3. In Back Office → Users, add the rest of your staff. Make each cashier Staff or Manager, and choose in Permissions what staff cashiers may do on their own. Give each person only the access they need. Add a Kitchen Screen account for each kitchen display.
  4. Build the catalogue in Menus and Options (VAT rates are a tab in Menus), set Sales Settings → Order Rules (including which order types and payment methods you offer) and Tips, and set up the card terminal in Local Settings → Caller ID & Clover.
  5. Open Back Office → Licence and check that the right licence and optional modules are active.
  6. In Back Office → Database, turn on Automatic Backup or plan another regular backup.
  7. Run test orders through your normal ordering and printing routine, without taking real payments, before you open.