Adding Devices
SyncID communicates with ZKTeco devices over TCP to manage employees, collect attendance logs, and monitor device health.
Adding a new device
Section titled “Adding a new device”- Navigate to Devices in the sidebar
- Click Add Device
- Fill in the required fields:
| Field | Description | Example |
|---|---|---|
| Name | Descriptive label for the device | Main Entrance |
| IP Address | Device’s LAN IP address | 192.168.1.100 |
| Port | Communication port (default: 4370) | 4370 |
| Serial Number | Device serial (found on device label or Menu → System Info) | ABC1234567 |
| Model | Device model for capability detection | iFace702 |
- Click Save — SyncID immediately attempts to connect
Device status
Section titled “Device status”After adding a device, SyncID monitors its connectivity:
| Status | Meaning |
|---|---|
| Online | Device is reachable and communicating normally |
| Offline | Device is unreachable — after 3 consecutive failed checks, an email alert is sent |
| Disconnected | Device was manually disconnected by an admin |
The online check runs automatically every 10 minutes.
Device operations
Section titled “Device operations”From the device detail page, you can perform several operations:
Sync employees to device
Section titled “Sync employees to device”Pushes all active employees (with their authentication templates) to the device. Use this after adding a new device or when employees have been updated.
Collect attendance records
Section titled “Collect attendance records”Manually triggers attendance record collection from the device. Useful for testing or one-off collection outside the scheduled job.
Sync device time
Section titled “Sync device time”Synchronizes the device’s internal clock with the server time. This prevents timestamp drift on attendance records. An automatic time sync job runs periodically.
Clear attendance logs
Section titled “Clear attendance logs”Removes attendance records from the device’s internal storage after they’ve been collected. Device storage is limited — clearing old logs prevents storage full errors.
Restart device
Section titled “Restart device”Sends a remote restart command to the device. Use this when a device is behaving erratically.
Network requirements
Section titled “Network requirements”- Protocol: TCP
- Port: 4370 (default, configurable per device)
- Direction: SyncID initiates connections to devices (outbound from SyncID host)
- Firewall: Port 4370 must be open between the SyncID host and each device
Troubleshooting
Section titled “Troubleshooting”Device stays offline after adding
Section titled “Device stays offline after adding”- Ping the device from the SyncID host:
ping <device-ip> - Verify port 4370 is open:
telnet <device-ip> 4370 - Check that the device is not in “Standalone” communication mode (should be set to TCP/IP)
- Ensure the SyncID host has network routing to the device’s subnet
Connection drops intermittently
Section titled “Connection drops intermittently”- Check the network infrastructure (switches, cables) between SyncID and the device
- Review the device offline events log in SyncID for patterns
- Consider enabling the automatic reconnection feature
Employee sync fails to device
Section titled “Employee sync fails to device”- Verify the device has sufficient storage (check device info on the detail page)
- Check that biometric templates are in a format supported by the device model
- Review the application logs for specific error messages