Skip to content
SyncID Docs

First Sync

This tutorial walks you through connecting your first ZKTeco device and running the initial employee sync with SyncrOne.

Prerequisites

Section titled “Prerequisites”

Before you begin, ensure:

  • SyncID is installed and running
  • You have a ZKTeco device powered on and connected to the same network
  • You know the device’s IP address (check on the device: Menu → Communication → Ethernet)
  • The SyncrOne API is reachable from the SyncID host

Step 1: Add your first device

Section titled “Step 1: Add your first device”
  1. Log in to SyncID as an admin
  2. Navigate to Devices in the sidebar
  3. Click Add Device
  4. Fill in the device details:
    • Name: A descriptive name (e.g., “Main Entrance”)
    • IP Address: The device’s LAN IP (e.g., 192.168.1.100)
    • Port: 4370 (default for ZKTeco devices)
    • Model: Select your device model (e.g., iFace702)
  5. Click Save

SyncID will attempt to connect to the device. If successful, the device status will show as Online.

Step 2: Sync employees from SyncrOne

Section titled “Step 2: Sync employees from SyncrOne”
  1. Navigate to Employees in the sidebar
  2. Click Sync from SyncrOne (or wait for the automatic sync job)
  3. SyncID pulls the employee list from the SyncrOne API
  4. Employees appear in the list with their details

The sync job runs automatically on a configurable schedule. The default interval is every 30 minutes.

Step 3: Push employees to the device

Section titled “Step 3: Push employees to the device”
  1. Go to Devices → select your device
  2. Click Sync Employees to Device
  3. SyncID pushes employee data (names, IDs, authentication templates) to the device
  4. Employees can now authenticate at the device

Step 4: Collect attendance records

Section titled “Step 4: Collect attendance records”

Once employees start punching in/out at the device, SyncID collects these records automatically:

  • Real-time mode: If enabled, SyncID receives events instantly via live streaming
  • Polling mode: SyncID periodically polls the device for new records (configurable interval)

To verify, check Attendance in the sidebar — you should see records appearing.

Step 5: Verify SyncrOne delivery

Section titled “Step 5: Verify SyncrOne delivery”

Attendance records collected from devices are automatically forwarded to SyncrOne:

  1. Check the Attendance page for the sync status column
  2. Records marked as Sent have been delivered to SyncrOne
  3. Records marked as Pending are queued for the next delivery batch

You can monitor delivery progress from the scheduled tasks page in SyncID.

What happens next

Section titled “What happens next”

With the initial setup complete, SyncID runs autonomously:

  • Employee sync — new employees from SyncrOne are automatically picked up and pushed to devices
  • Attendance collection — records are collected continuously and forwarded to SyncrOne
  • Device monitoring — device health is checked every 10 minutes with email alerts for offline devices
  • Time sync — device clocks are corrected automatically to prevent drift

Next steps

Section titled “Next steps”