Skip to main content



Before proceeding with the installation of the Java Agent, ensure that your system meets the following requirements:

  1. Operating System:

    • Windows
  2. Hardware:

    • Minimum of 4 GB RAM
    • Minimum of 80 GB hard disk space
  3. Internet Connection:

    • An active internet connection is required for downloading and push the data to facilio cloud.
  4. Network Connection:

    • Ensure that the system is connected to the Building Management System (BMS) network for proper communication.

Pre-requisites For OPC Ua#

  • Download Self Singed Certificate : Link

Steps to establish the Connection:#

    A. Create an agent in the Facilio Platform.    B. Install the Facilio Agent in the system.    C. Start the Facilio Agent.

A. Create an Agent in the facilio platform#

Step 1 - Navigate To Iot Page#

  • Login to the account using the credentials given to you.
  • Homepage > Go to settings >> Click on Portals >>> Click on Work Centers >>>> Click on Agent.




Step 2 - Add Agent#

Below is the Agent portal overview which can show up the number agents that are active, controllers that are associated with the network, points to capture the readings,etc.. To create an agent, follow the below steps.

  • Click on Add Agent.

Add agent

  • Select the Agent Type as Facilio, Type in Agent Name.
  • Also select the Site name where the agent has to be implemented. Then click on Save.

Add agent

Step 3 - Certificate & Config files#

  • Go to Agents and you will see the list of agents that you have added.
  • Select the Agent that you have added and Download the Certificate, Config file and extract files from the downloaded zip folder.


Download Certificate

  • Create a Folder facilio in user home directory (C:\Users\CurrentUserName\facilio)

Config files

  • Move the Extracted files (1.facilio.config 2.facilio.crt 3.facilio.private.key) to facilio Folder, Created in previous step.
  • If the protocol is OPC Ua, place selfsigned certificate here which is downloaded from OPC Ua Pre-requisites.

Config files

B. Install the Facilio Agent#

Follow the steps listed below to install the Java Agent:

  • Download and install JDK 8 (Java Development Kit) from this link.

  • Download the Facilio agent installer from this link, Copy and past the link in the new tab to download.

  • Double click to open the installer (FacilioAgentInstaller.exe). Accept the agreement and click on Next.

  • Choose the installation location and click on Next.

  • Uncheck the option "Create a desktop shortcut" and click on Next.
  • Click Install in the next screen.

  • Options ‘Run uninstallService.bat’ and ‘Run installService.bat’ should be checked.
  • Next, click on Finish.

  • Close all the consoles opened during installation.

C. Starting the Agent#

Now that the Java Agent is installed in the system, you will need to start the agent to make it online.

  • Open Task Manager and click on the Services tab.

Config files

  • Search for Facilio Agent and then right-click on it and then click on Start. Facilio Agent will take few minutes to come online.

Config files

  • Once it's online, Go to the Agent Portal, now the Facilio Agent will be online. The Agent is ready to communicate with the networks.

Config files

Firewall configuration (If Needed):#

Outgoing connection to

  • Endpoint : Endpoint can be found in facilio.config file, MQTT Port : 8883
  • Endpoint :, HTTPS Port : 443,80

if you configured the firewall and connection couldn't established, then check with following command:
  • Windows (PowerShell): Test-NetConnection -ComputerName <aws endpoint> -Port 8883
    • In respone TcpTestSucceeded should be true, if not check with firewall configurations.

Troubleshooting Tips#


If the agent is not running, here are a few troubleshooting tips that you can try –

  • Check whether the Java version, it should be JDK 8. (Command to check: java -version)
  • If the service is installed but the Facilio agent is not starting you can open Task Manager, go to Services tab and stop the service. Next, go to the Processes tab and stop any Facilio process that is running. Lastly, go to the Details tab and stop any java.exe that is running. Finally, you can restart the service.
  • If the agent is up and running but is not pushing any data to the cloud, please check whether the certificate and the config files (facilio.config, facilio.crt and facilio-private.key) are placed in the right location.
  • If Controllers / Points are not discovering, try to discover them in the BDT tool. Make sure facilio agent is not running.
  • For BACnetIp, the agent uses port 47808. So the port must not be occupied by any other processes in the system.
  • If the none of the above is working, please mail the below-mentioned log files to this email id –
    • C:\Users\<(current-user)>\facilio\logs\agentlog
    • C:\Program Files (x86)\Facilio\Logs\servicelog