Welcome to the IBIS Application Installation and Update Guide. Follow these steps to quickly and smoothly install or update the IBIS application. 


TABLE OF CONTENTS


Step 1: Prerequisites

Before proceeding with the installation, ensure the following requirements are met: 

  • System Requirements: Your computer meets the minimum requirements (see recommended specifications).
  • Administrator Access: You are logged into your Windows computer as an Administrator during installation.  
  • Firewall Configuration:

    • Allow downloads from https://setup.ibisres.com (for .ZIP files).
      If you prefer to update from a networked file location, please refer to the Advanced install Options for details.

    • Allow incoming/outgoing TCP/IP requests through ports 80 and 443 for the following IP addresses:

      • 52.255.45.74  
      • 4.198.90.72
  • IBIS Server Details: You have the server connection details provided by your IBIS contact.  
  • Login Credentials: You have a login name and password (provided by IBIS for new system setups only). 


Step 2: Downloading the software

  1. Click the Download button to initiate the IBIS installation. This installation supports Windows 7- 11.
    Install for Version 7
  2. Choose to run or save the file. If saved, locate the file and double-click to run it. 
  3. IBIS will copy files to your computer, and the install program window will appear. 
  4. Accept default settings or choose a specific installation folder. 
  5. When the installation is complete, click Close. 
  6. After installation, update to the latest IBIS version (see hotfix release).


Step 3: Opening the application for the first time

  1. Double-click the ibisNx shortcut on your desktop. 
  2. When the Login screen appears, click the Server button.
  3. Select Add new and enter the provided server code from IBIS, then click OK. The server code will be added to the Server Connections list and Server code field. 
  4. The address will default automatically to our hosted server URL https://NxServer.ibisres.com. Keep this unless you host your IBIS server locally, or have been instructed to change it by an IBIS technician, then click OK.
  5. Enter your Logon Name and Password, then click Logon to open the application.


A successful connection will sync with the server on startup before opening the application.



Step 4: Advanced install options

Change the default installation folder

By default, ibisNx installs to C:\IBIS. You can specify a different location during installation if needed. 


Turn off automatic updates from the web

IBIS maintenance fees include application updates. The system includes an Updater Tool, allowing you to:

  • Manage new releases, including major updates and optional hotfixes

  • Roll back to the previous major versions if needed

By default, the Updater Tool checks for the latest versions from our updates website: https://setup.ibisres.com/ibisnx/nxs/


If you require more control over the update process, you can configure the tool to check a locally hosted updates folder during installation as follows:

  1. Select a network folder as the location for the IbisNx version files to be saved and deployed from.
  2. Navigate to https://setup.ibisres.com/IbisNx/nxs/ and download the latest major version (major versions are indicated by ending in .00.00, e.g. 25.00.00). 

    Setup IBIS

  3. Save this .ZIP file into your network <sourcepath> folder.
  4. Download the IBIS application (as per Step 2) and choose to either run or save the file (if you choose to save, navigate to your saved location and double-click the file to run it).
  5. The IBIS install will launch a countdown window during the install, select Stop to suspend the countdown to enable you to edit the installer to point to your networked folder.

    Wait Dialogue

  6. Edit the installer to point to the networked <sourcepath>
    • Untick Web Update
    • Tick Network File Update
    • Browse to your network folder <sourcepath> to find the version files you saved in step 2. If you cannot see your network drives, you may need to lower your Windows user access control settings during the installation.
    • Once updated, continue with the install; click Try Again
      Change Source Path
  7. The IbisNx installer will download the latest version from your network folder to complete the installation.

From time-to-time, IBIS release required updates to the software. In these situations, IBIS will communicate in advance to all customers. If you have configured your updates from a local folder, you will need to download the version update files from our website into that folder. 


Proxy authentication configuration

By default, the IBIS application installed on your desktop communicates with your IBIS server via port 443 (the standard port for secure web traffic). 


If your network uses a proxy server, you must configure IBIS to route traffic through the designated port and address set by your IT department.


To enable proxy configuration in IBIS, follow these steps:

  1. From the Login screen, click the Server button in the top right-hand corner. 
  2. When the Server Connection screen opens, click the Network tab
  3. Under the Proxy Settings section, tick the box use proxy.
  4. Enter your proxy address and port number (these can be found in your web browser settings if you don't know this information.


Troubleshooting

If you have any problems installing the ibisNx application, you may be able to fix them easily by trying some of these tips.


I tried opening the IBIS application and get an error ‘Connection to the server has been lost’?

If you encounter this error when opening the IBIS application, check the following:

  • Server Connection Details: Ensure your IBIS server address and login credentials are correctly entered.

  • Internet Access: Verify that your computer is connected to the internet.

  • Firewall Settings: Confirm that your firewall allows traffic to and from the IBIS server.

  • Antivirus Software: Check if your antivirus is blocking IBIS from accessing the internet.


The application just shuts down when I try and open it.

If you have just installed IBIS and you cannot launch the application, it is likely being blocked by your antivirus software. Ensure you allow the IBIS application to run in your antivirus software.


I get an unhandled exception error when I try to open IBIS. 

Check you have installed Microsoft .Net 4.7 or later in your Programs List (Control Panel\Programs\Programs and Features). Check your firewall is configured to allow updates from http://setup.ibisres.com/ibisnx


When I open the Point of Sale screen, I get a pop up ‘Please enter a unique 10 character name for the till’

Check the till name has been entered into the Machine settings screen. If not, enter the correct till name directly into that screen.


When I open the point of sale screen I get a warning ‘Till name ‘x’ could not be found in the list of tills for this location …..’

Check you have a list of till names in the Devices screen and you have spelled the till name correctly in the Machine settings (it is space sensitive).


I am getting a communication/networking error when I try and log in that says Proxy Authentication Required.

You will need to configure IBIS to communicate via your Proxy server. Check the Advanced install section for details.