Installation, setup, and application lifecycle
Zenoti Biometrics is a Windows desktop application that enables fingerprint-based employee attendance at your center. This article explains how to install the application, configure it for first use, and understand how the application behaves across restarts, upgrades, and uninstallation.
Note: For conceptual background on how Zenoti Biometrics fits into the broader employee attendance system, see Zenoti Biometrics overview.
Audience: IT administrators and center managers responsible for setting up and maintaining the Zenoti Biometrics application at a center.
On this page
Before you begin
- A Windows PC must be available at the center where biometric attendance will be used.
- A supported fingerprint scanner must be connected to the PC.
- Biometric attendance must be enabled at both the organization level and the center level in Zenoti before the application can connect. Navigate to Configuration > Employee > Employee attendance and confirm that Use a biometric device for employee attendance is enabled at both levels, and that Specify the type of authentication you want to use is set to Zenoti Biometrics.
- You must have an active Zenoti employee account with access to the center you are configuring.
Permission: You need an active Zenoti employee account with center access to sign in to the application. The application does not define its own roles β access is governed by your existing Zenoti account and center assignment.
Steps
Install the application
The Zenoti Biometrics installer is a single file that provisions all required prerequisites automatically. You do not need to install WebView2 Runtime, the .NET Desktop Runtime, or the Visual C++ Redistributable separately before running the installer.
- Download the Zenoti Biometrics installer from the link provided by your Zenoti account representative or the Zenoti Help Center.
- Run the installer on the center's Windows PC.
- The installer automatically detects and provisions any missing prerequisites, then installs the application.
- When installation completes, the application is ready to launch.
Note: The installer handles all prerequisite provisioning in a single pass. If a prerequisite is already present on the machine, the installer skips it.
Launch and complete initial setup
- Launch Zenoti Biometrics from the Windows Start menu or desktop shortcut.
- If this is the first launch (or if Show configuration screen on startup is enabled), the application displays the initial configuration screen.
- On the configuration screen, enter your organization's Account name in the Account name field.
- Click Continue to save the cloud connection settings.
- On the sign-in screen, enter your Username and Password, then click Sign In.
- After signing in, select your center from the Select Your Center screen. Use the Search Centers field to filter by name or location if needed.
- Click your center to proceed. The application loads and displays the Biometric Attendance System dashboard.
Tip: If you want the configuration screen to appear on every launch β for example, to reconfigure the cloud connection more often β enable Show configuration screen on startup in Settings > Cloud Configuration. See Configure the startup screen option below.
Worked example: An IT admin at Serenity Spa sets the Account name to serenityspa, clicks Continue, signs in with their Zenoti credentials, and selects the Downtown center. The dashboard loads and shows Biometric Attendance System with the center name displayed.
Configure system tray behavior
Zenoti Biometrics runs as a Windows desktop application with a system tray icon. You can control what happens when you close the main window.
In the application, navigate to Settings.
Under Application Settings > System Tray, configure the following options:
Show system tray icon β Enable to display the application icon in the Windows system tray while the application is running.
Minimize to tray on close β When enabled, clicking the window's close button minimizes the application to the system tray instead of exiting. When disabled, clicking close exits the application entirely.
Important: When Minimize to tray on close is enabled, the following behavior applies: "X button minimizes to tray instead of closing. If attendance mode is on, checkin/checkouts will continue to be recorded in the background." This means fingerprint attendance scanning continues uninterrupted even when the main window is not visible.
Lock on restore from tray β When enabled, restoring the application from the system tray requires the user to unlock the screen first.
Start minimized to tray β When enabled, the application launches directly to the system tray without showing the main window.
Click Save to apply your changes.
Configure the startup screen option
You can control whether the initial configuration screen appears each time the application starts.
- In the application, navigate to Settings.
- Under Application Settings > Cloud Configuration, locate the Show configuration screen on startup toggle.
- Enable the toggle if you want the configuration screen to appear before the sign-in screen on every launch. This is useful when the cloud connection settings need to be reviewed or updated regularly.
- Disable the toggle to skip the configuration screen and proceed directly to sign-in on subsequent launches.
- Click Save to apply your changes.
Uninstall the application
Zenoti Biometrics can be removed using the standard Windows uninstall process.
Important: Uninstalling the application removes all locally stored application data, including enrolled fingerprint templates and logs. This action cannot be undone. If you need to preserve audit logs before uninstalling, export them first from Settings > Logs > Export Audit Logs.
- Open Windows Settings and navigate to Apps (or Add or Remove Programs on older Windows versions).
- Locate Zenoti Biometrics in the list of installed applications.
- Select the application and click Uninstall.
- Follow the on-screen prompts to complete the removal.
All locally stored application data is removed as part of the uninstallation process.
Upgrade to a newer version
When a newer version of Zenoti Biometrics is available, the application notifies you. Installing a newer version over an existing installation preserves your locally stored settings, enrolled fingerprint data, and logs.
When an update notification appears:
Review the update details shown in the Update Available dialog, including the version number, download size, and what's new.
Choose one of the following options:
Method 1: Install immediately
- Click Install Now to download and install the update right away. The application will restart automatically after installation.
Method 2: Schedule for next restart
- Click Install on Next Restart to download the update in the background. The update installs the next time the application restarts. You can continue working during the download.
If the update is marked as mandatory (for example, it contains critical security or stability fixes), the Mandatory Update Required dialog appears. In this case, click Start Update Now to begin the update immediately.
Important: Do not close the application manually during installation. The application restarts automatically after the update completes.
Note: After upgrading, your enrolled fingerprint data, application settings, and logs are preserved. You do not need to re-enroll employees after a version upgrade.
Worked example: A center manager sees the Update Available notification showing version 2.1.0 with a 45 MB download. They click Install on Next Restart and continue running attendance mode. That evening, they restart the application and the update installs automatically. All previously enrolled employees remain enrolled and the center's settings are unchanged.
Tips
- Keep the application running during business hours. When Minimize to tray on close is enabled, closing the main window keeps attendance scanning active in the background. Employees can continue checking in and out even when the window is not visible.
- Use the startup screen option for multi-center deployments. If a single PC is occasionally reconfigured to connect to a different center, enable Show configuration screen on startup so the account name can be verified on each launch.
- Export audit logs before uninstalling. If you plan to remove the application, export audit logs from Settings > Logs > Export Audit Logs first. Uninstallation removes all local data permanently.
- Test the fingerprint scanner connection before enabling attendance mode. The application displays scanner status on the dashboard. Confirm the scanner shows as connected before starting attendance mode to avoid interruptions.
- Mandatory updates take priority. If a mandatory update deadline is reached, the application starts the update immediately regardless of current activity. Plan maintenance windows accordingly.
Troubleshooting
- The application shows "Connecting..." and does not proceed to the sign-in screen. The application cannot reach the Zenoti cloud. Verify that the Windows PC has an active internet connection. Check that the Account name entered in Settings > Cloud Configuration matches your organization's Zenoti account name exactly. If the issue persists, click Contact Support on the sign-in screen.
- The configuration screen does not appear on first launch. If Show configuration screen on startup was previously disabled (for example, by a prior installation), the application skips directly to sign-in. Navigate to Settings > Cloud Configuration and enable Show configuration screen on startup, then restart the application to see the configuration screen.
- After uninstalling and reinstalling, enrolled fingerprints are gone. Uninstallation removes all locally stored data, including enrolled fingerprint templates. This is expected behavior. After reinstalling, employees must be re-enrolled. See Fingerprint enrollment for the enrollment procedure.
- The application does not prevent a second instance from opening. Zenoti Biometrics prevents more than one instance from running on the same machine at the same time. If you attempt to launch a second instance, the existing instance is brought to the foreground instead of opening a new window. If you see two windows, restart the application.
- An update fails and the "Retry Update" button appears. Click Retry Update to attempt the installation again. If the update continues to fail, click Exit Application, relaunch the application, and allow the update to restart. If the problem persists, contact Zenoti Support.