BioStar 2 - My BioMini USB Scanner does not work - Troubleshooting BioMini

BioStar 2 - My BioMini USB Scanner does not work - Troubleshooting BioMini

Biomini is the USB fingerprint reader used for biometric enrollment. 

Supported devices in BioStar 2 are shown in the link below: 

[Both BioStar] Biomini and Biomini Plus support

Biomini agent / USB Agent needs to be installed in the client PC in order to recognize the device in BioStar 2. 

You can download the program from Setting > Usb Agent of BioStar 2 web client


Up to BioStar 2.3, the program was called Biomini Agent because only biomini was used with the program. 

However in BioStar 2.4 the program's name changed to USB Agent because it now supports DE-620 as well. 


Note: Although you have a option to check 'run on Windows startup', the USB Agent will not run automatically (up to BioStar 2.5) because of a bug. 

You will have to run USB Agent manually in the Windows start menu when you restart your PC.

[This feature does not work up to BioStar 2.5] 

1. Install the latest driver

First check that the latest fingerprint driver is installed (version 2.2)

Direct download link: 


Note: unplug the Biomini when you are installing the driver.

The driver can also be found at the EasySecure website under software -> BioStar


2. Check Device manager

Open device manager and check that Suprema Fingerprint Scanner is detected properly. 

3. Check USB Agent Certification

USB Agent is running. You can search it in the Windows start menu. 

Once the program is running right click on the USB Agent icon on the system tray and click Setup.

Click Enroll Certificates and click Yes when a Security Warning popup appears to enroll the certificate. 

Restart the service by clicking Stop and then Start 

4. Check the BioStar 2 Device menu

If  all settings are configured properly, the device should appear as a USB device on the Device menu. 



1. Check if the USB Agent port is being used by another service 

You currently (BioStar 2.5) cannot change the default port use of the USB Device Agent of 8081 and 8082 because of a UI bug. 

Check that port 8081 and 8082 is not being used by another service.  

Refer to the guide below: 

[General] Checking Port Usage in Windows

If another service is using port 8081 and 8082 then service will crash or 'Started' will be not shown when you click Start.
Remove the other service that is using the same ports. 

Or you can change the Biomini Agent port in BioStar 2.6 as desired and above as shown below: 

[BioStar 2] Changing Biomini / USB Agent Port

If you must change the USB Agent port in BioStar 2.5 or below refer to the guide below: 

[Known Issue] Biomini Agent / USB Agent Port Cannot be Changed

2. Change Access privileges
If you're getting the error below every time when scanning the fingerprint with Biomini, it is likely that USB Agent is being run with insufficient privileges.

In that case stop the process first in Task Manager.

In BioStar 2.3 or below the service will appear as Biomini-Agent.exe *32

In BioStar 2.4 and above the service will appear as usb-agent.exe *32

Search the Biomini Agent / USB Agent in Windows Start menu and select the Properties menu after a right click. 

Check Run this program and an administrator on the compatibility tab and click OK

Run Biomini Agent / USB Agent again. 

3. Check the API

If you are using a proxy server, you will have to add the localhost as an exception.

You can check if the localhost is working correctly by trying to access the URL below:

localhost:[webserver port]/api/device

The image above shows that the connection is possible and working.

If you get a error message like below even if BioStar 2 service is running, it means that localhost connection is blocked. 

4. Check the USB Agent logs

You can find the USB agent logs in the folder below: 

C:\Program Files (x86)\USB Device Agent\usb-agent\logs

Open the log files to see what errors are appearing. 

Provide the log file to the technical support team when requested. 

    • Related Articles

    • BioStar 2 - How to solve problems enrolling with BioMini

      BioMini is the USB fingerprint reader used for biometric enrollment.  BioMini agent / USB Agent needs to be installed in the client PC in order to recognize the device in BioStar 2.  You can download the program from Setting > USB Agent of BioStar 2 ...
    • - How can I enroll a finger?

      After adding a new user in your EasySecure environment you will arrive in the following screen. To enroll a new finger you have to click the icon 'Finger Templates'.  The following window will become visible:  Please select the scanner you wish to ...
    • - How do I update the BioMiniAgent?

      From 25-04-2020 the license to use your BioMini will expire. The BioMini is the USB scanner that you may use to add new fingers in the software.  This license has been automatically updated in recent days. In the unlikely event that this update was ...
    • BioStar 2 - Hoe verhelp ik problemen bij het inlezen met de BioMini

      In dit document willen we graag uitlegen hoe u problemen kunt verhelpen wanneer u een probleem opmerkt tijdens het inlezen met de BioMini bij inlezen in BioStar 2.   Voordat we beginnen gaan we er vanuit dat de driver ...
    • - Wie aktualisiere ich BioMiniAgent?

      Diese Lizenz wurde in den vergangenen Tagen automatisch aktualisiert. Im unwahrscheinlichen Fall, dass das Update aufgrund fehlender Verbindung oder eines ausgeschalteten PCs nicht ausgeführt wurde, sind einige Schritte notwendig, um die Lizenz für ...