Install FMX EPOS
FMX EPOS for 64-bit Windows comes as an installer, FMX-EPOS-Setup-<version>-x64.exe, a single file that contains everything FMX EPOS needs. For 32-bit Windows, ask FMX EPOS for the portable package (x86).
Before you start
Section titled “Before you start”Check that:
- The computer runs a supported version of Windows and keeps accurate time.
- You have the right download: the installer for 64-bit Windows (most computers), or the x86 portable package only for 32-bit Windows.
- You can sign in to Windows as an administrator, or have an administrator’s name and password to hand. The installer needs administrator rights.
- If this till will use SQL Server or MySQL, you have the server address, database name and login details from whoever manages that server.
FMX EPOS keeps its local settings and certificates inside its installation folder. So does the restaurant database, with local storage or when first-run setup installed MySQL on this PC. The Windows account that runs FMX EPOS must be able to write to the folder. The installer does not install into the Windows or Program Files folders.
Protect the folder:
- Only the Windows accounts that run FMX EPOS should be able to change it. FMX EPOS can run with administrator rights, and a folder directly under
C:\, such as the installer’s suggestedC:\FMXEPOS, can be changed by every Windows user on the computer by default. If other people sign in to this computer, ask whoever maintains it to restrict the folder’s permissions. - It holds the restaurant’s security certificate and may hold its data. Protect the folder and its backups as carefully as you would a database backup.
Install with the installer
Section titled “Install with the installer”-
Run
FMX-EPOS-Setup-<version>-x64.exe. When Windows asks whether to allow the app to make changes, select Yes. -
On Install FMX EPOS, tick I agree to the Terms and Conditions and the Privacy Policy, then select Next. Next stays unavailable until the box is ticked. If FMX EPOS is already installed on this computer, the installer opens on FMX EPOS is on this PC instead. See Upgrade, repair or uninstall below.
-
On Choose where to install, keep the suggested Installation Folder or select Browse…. The folder must be on this computer, outside the Windows and
Program Filesfolders, and on a drive with enough free space. The space needed and the space free are shown under the folder.- If you choose a drive, or a folder that already has other files in it, FMX EPOS goes in an
FMXEPOSfolder inside it. A notice under the folder shows where. - A folder that holds an earlier FMX EPOS, or the data an uninstall kept, is used as it is, and its data is kept.
Select Install.
- If you choose a drive, or a folder that already has other files in it, FMX EPOS goes in an
-
Wait while the installer copies the files, installs Microsoft Edge WebView2 Runtime if the computer does not have it, and adds FMX EPOS to Windows’ installed apps, with a Start menu shortcut for everyone who uses this computer. Its Windows Firewall, Clover and HTTPS step lets other devices reach FMX EPOS through Windows Firewall (ports 5139 and 5140, on private and domain networks, from the local network only), prepares Windows for a Clover card terminal and makes this PC trust the till’s HTTPS certificate. If a step fails, the installer marks it Failed and shows the reason. Select Close, deal with the reason and run the installer again. If the Windows Firewall, Clover and HTTPS step reads Not finished, the installation still completes, and the finish page says what was not done and what to do; for Clover it gives a command to run once in PowerShell as an administrator.
-
On FMX EPOS is installed, choose how it starts on this computer. All three options start ticked:
- Add a shortcut to the desktop
- Start FMX EPOS when anyone signs in to Windows
- Start FMX EPOS now to set up the shop
The desktop shortcut and starting at sign-in apply to every Windows account on this computer. If Windows asked for another administrator’s name and password to run the installer, the last choice is not shown, because FMX EPOS would then run as that administrator. Start it from its shortcut instead.
If this computer does not have .NET Framework 4.8.1, the page also shows Optional Clover support. Clover card terminals need it. Select Install .NET Framework 4.8.1 if this till will use Clover, and wait for the result; the installer carries Microsoft’s offline copy, so no internet connection is needed. If it says “Restart Windows before using Clover”, you can still finish now and restart later. Skip it if you do not use Clover. A failed or skipped installation does not affect FMX EPOS itself.
-
Select Finish. With the last box ticked, FMX EPOS starts straight away. The page also links to the Quick Start guide.
Install FMX EPOS
Install the till, Back Office, kitchen screen and customer display on this PC.
Illustration, not a screenshot. The real screen can differ with the theme or version.
Start FMX EPOS when anyone signs in to Windows starts FMX EPOS for whoever signs in, with the highest rights that Windows account has. On an administrator’s account, FMX EPOS can then correct the Windows clock without asking (see Windows clock check). One till runs on a computer at a time: while FMX EPOS is running for one Windows user, signing in as another user does not start a second one.
You can change these choices later on the Windows card in Back Office → Local Settings → This Terminal, in the desktop app on that computer. Each button first asks you to confirm with Yes or No.
- Desktop shortcut: Create (or Update) and Remove. A shortcut created here is for the Windows account you are using. A desktop shortcut that the installer added for every Windows user can be removed only with administrator rights. If FMX EPOS says “This shortcut is for every Windows user. Start FMX EPOS as an administrator to remove it.”, right-click FMX EPOS, choose Run as administrator and try again.
- Taskbar shortcut: Set Up opens the FMX EPOS folder in File Explorer with the program selected. Right-click it and choose Pin to taskbar.
- Start at Windows sign-in: Enable or Disable. Changing it needs Windows administrator rights. If FMX EPOS refuses, right-click FMX EPOS, choose Run as administrator and try again.
- HTTPS certificate: Trust Certificate (see Install the shop’s certificate).
Windows
- Desktop shortcutCreatedUpdateRemove
- Taskbar shortcutSet Up
- Start at Windows sign-inEnabledDisable
- HTTPS certificateTrust Certificate
Illustration, not a screenshot. The real screen can differ with the theme or version.
Upgrade, repair or uninstall
Section titled “Upgrade, repair or uninstall”When FMX EPOS is already installed, the installer opens on FMX EPOS is on this PC and keeps it in the folder it is installed in. Close FMX EPOS first, then tick I agree to the Terms and Conditions and the Privacy Policy. The installer does not continue while FMX EPOS is running (“FMX EPOS is running on this PC. Close it, then try again.”) or when the drive does not have enough free space, and it checks both before it changes anything.
- Upgrade appears when the installer is newer than the installed version.
- Repair appears when it is the same version, and replaces the program files.
- Uninstall removes FMX EPOS as described in Uninstall FMX EPOS below.
FMX EPOS is on this PC
FMX EPOS 2.0.470 is installed in C:\FMXEPOS. Upgrade it to 2.0.478? The program is updated. If this version changed the database structure, you will need to choose the database again.
Illustration, not a screenshot. The real screen can differ with the theme or version.
Upgrading and repairing replace only FMX EPOS’s own program files, and repeat the Windows Firewall, Clover and HTTPS step. They keep this computer’s settings, certificates, licence and logs, any other files in the installation folder and, with local storage, the restaurant database file. The finish page starts with this computer’s current shortcut and sign-in choices, and its last box reads Start FMX EPOS now. It offers Optional Clover support in the same way when .NET Framework 4.8.1 is missing. If an upgrade stops with an error, run the installer again to finish it.
The installer’s upgrade notice says that if the new version changed the database structure, the till cannot use its existing database and asks for a new or empty one. There is no way to upgrade that database:
- When FMX EPOS next starts, it opens first-run setup at the Database stage and says that the database’s structure does not match this version. Choosing the same database again is refused with the same message.
- To carry on, choose a new, empty database. The old data is not carried over, and an export from the old version cannot be imported into the new one.
Before you upgrade, back up the restaurant’s data and ask your FMX EPOS support contact whether the new version changes the database structure.
An installer older than the installed version stops at this point. Use the installer for that version or a later one.
Portable package (32-bit Windows)
Section titled “Portable package (32-bit Windows)”- Copy the complete x86 package to the computer.
- Extract the whole archive into its final folder. Do not run FMX EPOS from inside the archive. Keep its files together, because the main program file does not run on its own.
- If Microsoft Edge WebView2 Runtime is missing, run its installer from the package’s
prerequisitesfolder. If this till will use a Clover card terminal and Windows does not have .NET Framework 4.8.1, run that installer from the same folder too. - Open the folder and run FMXEPOS.exe.
- prerequisitesInstallers for WebView2 and .NET Framework 4.8.1, if Windows needs them
- runtimeThe .NET runtime FMX EPOS runs on
- webThe till program. Its settings and data are kept in its .runtime folder
- FMXEPOS.exeStart here
- FMXEPOS.dll …Program files that FMXEPOS.exe needs beside it
- VERSION.txtPackage version
- PACKAGE-FILES.txtList of the files in the package
The portable package adds no shortcuts and does not start at sign-in. Add them on the Windows card in Back Office → Local Settings → This Terminal after setup.
Start FMX EPOS for the first time
Section titled “Start FMX EPOS for the first time”- Start FMX EPOS from the installer’s last page, from its shortcut or with FMXEPOS.exe in the installation folder. Windows does not ask for permission when FMX EPOS starts normally.
- Wait while FMX EPOS checks the Windows clock and starts. The first start takes longer.
- If Windows shows a Security Warning about the FMX EPOS certificate, select Yes (see Install the shop’s certificate). After a normal installation it does not appear.
- Complete first-run setup.
The desktop app opens the till full screen, along with any customer and kitchen displays you have configured. If a page in the till window looks stuck, press Ctrl+R to reload it. To close FMX EPOS, select Exit on the till sign-in page, or press Ctrl+Shift+Q, and confirm.
FMX EPOS runs once per computer. Starting it again in the same Windows account does not open a second copy. If another Windows user already has it running on this computer, it shows “FMX EPOS is already running for another Windows user on this PC.” and closes. Close FMX EPOS in that user’s session first.
Install the shop’s certificate
Section titled “Install the shop’s certificate”Each installation makes its own security certificate for its secure (HTTPS) connections. The installer adds it to the PC’s trusted certificates for every Windows user, so browsers on this PC open FMX EPOS pages without a certificate warning and nobody is asked. An upgrade or repair keeps the same certificate. If the installer could not do it, its last page says so, and the installation still finishes. Uninstalling removes the PC’s trust in the certificate again.
When the certificate is not trusted yet, for example on a portable copy, FMX EPOS asks Windows to trust it for the signed-in Windows user each time it starts. Windows shows one Security Warning about a certificate from the FMX EPOS root named on screen. Select Yes. Install it only on a till you control.
Security Warning
Install a certificate from FMX EPOS Root CA …?
Illustration, not a screenshot. The real screen can differ with the theme or version.
If you select No, FMX EPOS carries on without another message, and browsers on this PC may show a certificate warning. To be asked again, select Trust Certificate on the Windows card in Back Office → Local Settings → This Terminal. If Windows cannot add the certificate at all, FMX EPOS shows Certificate Setup Failed and keeps working. See A browser on the till PC itself.
Phones, tablets and other computers that open the till’s pages need the certificate installed on each device. The till’s HTTPS Certificate page gives the steps for iPhone and iPad, Android and other Windows PCs; see The browser shows a certificate warning and Browser staff ordering.
Windows clock check
Section titled “Windows clock check”FMX EPOS checks the Windows clock because order times, licence validity and secure connections all depend on it.
At start-up, FMX EPOS compares the clock with internet time and corrects it if it can. Correcting the clock needs administrator rights, which FMX EPOS has when:
- it starts at Windows sign-in on a Windows administrator’s account; or
- you right-click FMX EPOS and choose Run as administrator.
Started from a shortcut, FMX EPOS runs with normal rights and cannot correct the clock.
When the clock is 10 seconds or more out and FMX EPOS cannot correct it, FMX EPOS shows how far out it is and then closes:
FMX EPOS could not start
The Windows clock is 3 minutes behind internet time and FMX EPOS could not correct it.
Start FMX EPOS as a Windows administrator (right-click it and choose Run as administrator), or correct the Windows clock in Settings → Time & language, then start FMX EPOS again.
FMX EPOS will now close.
Illustration, not a screenshot. The real screen can differ with the theme or version.
- Right-click FMX EPOS and choose Run as administrator. FMX EPOS can then usually correct the clock itself.
- Alternatively, open Windows Settings → Time & language, check the time zone and the current date and time, turn on automatic time synchronisation if your network allows it, and synchronise the clock.
- Start FMX EPOS again.
If the difference is under 10 seconds and cannot be corrected, FMX EPOS keeps running. If internet time does not answer and the till uses a remote database, FMX EPOS compares the clock with the database server’s time instead, and the same message can name the database server’s time. If FMX EPOS could not check the clock at start-up, it checks again every 10 minutes. If it then finds the clock 10 seconds or more out and cannot correct it, the till shows “This PC’s clock is … out and could not be corrected. Close FMX EPOS and start it as a Windows administrator.” until the clock is right. If the computer is deliberately kept off the internet, whoever maintains it must keep the clock accurate by another trusted method.
Network access for other devices
Section titled “Network access for other devices”Other devices on the restaurant network can open the kitchen screen, host stand, customer display and staff ordering pages from the main till, over HTTPS on port 5139.
On a new installation, every other device is refused until you allow it. You can change this only in the desktop app on the till PC:
- Open Back Office → Local Settings → Security.
- Under Remote Access, tick what other devices need: Back Office Web Pages, Till Web — PC, Mobile & Customer Display, Kitchen Screen Web, Host Stand Web — PCs & Tablets or Mobile App.
- Select Save Security Settings.
Remote Access
Illustration, not a screenshot. The real screen can differ with the theme or version.
See Security and network access for what each switch allows. Then prepare the network:
- Give the till computer a fixed address on the local network. A reservation in the router is usually the simplest way to do this.
- Make sure Windows treats the restaurant network as a Private network. The installer opens FMX EPOS’s firewall ports on private and domain networks only, for devices on the same local network. If a device still cannot connect, run the installer again and choose Repair.
- If Windows Firewall asks, allow FMX EPOS on the private restaurant network.
- Keep staff devices on the same local network as the till. The firewall rules FMX EPOS adds itself accept only devices on that network.
- On devices that use the browser pages, install the till’s certificate from the link FMX EPOS shows. See Browser staff ordering.
Never open port 5139 to the public internet. Browser and Android staff ordering are meant to reach the till over the restaurant network.
If FMX EPOS does not start
Section titled “If FMX EPOS does not start”Work through these checks in order:
- Confirm that the installer finished, or that the portable package was fully extracted and its files are still together.
- Confirm that the Windows account can create and change files in the installation folder.
- If FMX EPOS asks to install Microsoft Edge WebView2 Runtime, select Yes, let the installation finish, then start FMX EPOS again. You can also run the installer in the
prerequisitesfolder of the installation folder. - Correct the Windows clock if a clock message appears. See Windows clock check.
- If FMX EPOS shows Another program is using port 5139, it names the program:
- If it is another copy of FMX EPOS, such as a second installation, close that copy. Only one copy can run on a computer at a time.
- If Windows uses the port for a web service, such as IIS, ask whoever maintains the computer to stop that service or move it to another port, then select Try Again.
- For any other program, select Close It and Start. FMX EPOS asks you to confirm, closes the program and carries on. Anything the program has not saved is lost. You can also close it yourself and select Try Again.
- Exit closes FMX EPOS.
- If FMX EPOS says it is already running for another Windows user, close it in that user’s session.
- Restart Windows if an earlier FMX EPOS process did not close properly.
- If the error persists, note the exact message and ask your FMX EPOS support contact to check the installation. Do not delete the application folder, because it may contain the restaurant database and local settings.
If FMX EPOS stops while it is running, its windows show Restarting EPOS… and it starts itself again. If it keeps stopping, it shows a message that starts “The local FMX EPOS service keeps stopping” and closes. Check that the database server is running and reachable, then start FMX EPOS again. If the message comes back, send its exact text to your FMX EPOS support contact.
Another program is using port 5139
Example Web Server · process 4120
FMX EPOS needs port 5139 to run. Close that program, or ask whoever maintains this PC to move it to another port, then select Try Again.
Illustration, not a screenshot. The real screen can differ with the theme or version.
Moving or copying an installation
Section titled “Moving or copying an installation”A configured installation belongs to its computer. Copying it to another computer duplicates that till’s terminal identity. The offline licence does not move with it: it belongs to the original computer, so the copy shows Other Computer on its Licence page.
If a copy that uses a remote database runs while the original is still in use, one of them shows Terminal Identity In Use. On the copy, select Create a New Terminal Identity in the till window. The copy then becomes a new terminal, and its printers have to be chosen again in Local Settings. See Database and continuity.
To add another till, install FMX EPOS on the new computer, choose the same remote restaurant database during setup, then activate or connect the licence for that computer. If you are replacing the original computer, keep its data and ask your support contact to plan the move before removing anything.
If this till’s data was deleted or the till has a new address, its certificate or address has changed. Select Pair With Another Till on each staff phone and pair again, and install the new certificate on any browser device.
Uninstall FMX EPOS
Section titled “Uninstall FMX EPOS”- Close FMX EPOS: select Exit on the till sign-in page, or press Ctrl+Shift+Q, and confirm.
- In Windows, open Settings → Apps → Installed apps, find FMX EPOS and select Uninstall. You can also run the installer and select Uninstall.
- When Windows asks whether to allow the app to make changes, select Yes. Removing FMX EPOS needs administrator rights. If you select No, nothing is removed.
- On Remove FMX EPOS, select Next. Nothing is removed until you choose Remove.
- On Choose what to delete, tick only what should go. Anything not ticked stays on this PC for installing again.
- Delete this till’s data: settings, certificates, licence, logs and, with local storage, the restaurant database. It also deletes sales and emergency bills this till has not yet sent to a remote database, and its saved MySQL passwords, so note the connection details and the root password first (Show Root Password on the This PC’s MySQL Server card in Back Office → Database).
- Remove the MySQL server: appears when FMX EPOS installed MySQL on this PC. Other tills using it lose access.
- Delete the MySQL databases too: every database on this server, with the shop’s orders, payments, menu and members.
- Select Remove. If you ticked anything that deletes data, confirm Delete and Remove at Delete the data for good?. Cancel goes back to your choices.
- FMX EPOS is removed says what was kept. The last program files go when the window closes.
Remove FMX EPOS
Remove the till, Back Office, kitchen screen and customer display from this PC, with their shortcuts and starting at sign-in.
You choose next whether this till’s data is kept. Nothing is removed until you choose Remove.
Illustration, not a screenshot. The real screen can differ with the theme or version.
If FMX EPOS is still running when you select Remove, the page says “FMX EPOS is running on this PC. Close it, then try again.” and nothing is removed.
If the installation folder’s program files were deleted by hand, the installer cannot uninstall and says “The program files are missing from …. Choose Repair, then Uninstall.” Select Repair first, then run the installer again and select Uninstall.
FMX EPOS removes its shortcuts, its start at Windows sign-in, its Windows Firewall rules and its entry in installed apps, then removes its program files once it has closed. Other files in the installation folder stay, and the folder itself stays while it still holds anything. A MySQL server that FMX EPOS installed stays unless you tick Remove the MySQL server. If its databases stay, installing FMX EPOS again in the same folder lets you go back onto them: see First-run setup.
If this till’s data was deleted, its certificate has changed. Select Pair With Another Till on each staff phone and pair again, and install the new certificate on any browser device.
Uninstalling removes the trust the installer gave the shop’s certificate for the whole PC. A Windows account that trusted it by answering Yes to the Security Warning keeps trusting it. To remove it there, sign in to that account, open Manage user certificates from the Windows search box, go to Trusted Root Certification Authorities → Certificates and delete the certificate whose name starts with FMX EPOS Root CA.
The portable package is not listed in installed apps. Close FMX EPOS and delete its folder yourself, keeping a copy of web\.runtime if you may need its data.