FLAGSHIP PRODUCT
Works with ZKTeco terminals • On-premise data • Role-based access

PRESENCE OS

Biometric workforce and access management for ZKTeco terminals.

PRESENCE OS connects ZKTeco biometric terminals to a modern web dashboard, turning raw punches into attendance, shifts, payroll-ready reports and access control. Your data stays on your own server.

On-premise data on your own PostgreSQL database. Cloud licensing with an offline grace period.

Employee Self-Service portal (Illustrative)
SYSTEM ARCHITECTURE

How PRESENCE OS Works

A 4-stage pipeline connecting ZKTeco biometric terminals to your on-premise dashboard.

ADMS Push Protocol
01

ZKTeco Biometric Terminal

Connects with ZKTeco biometric terminals over the ADMS (ICLOCK) push protocol. Captures verified biometric punches (face, fingerprint, RFID, palm) and pushes events in real time.

Face, fingerprint, RFID and palm verification
Real-time push from device to server
Offline punch buffer with sync on reconnect
ADMS Gateway & Database
02

PRESENCE OS Server

Dedicated on-premise middleware listening on the ADMS port. Validates hardware push events, executes remote terminal commands, and commits records directly to your local PostgreSQL database.

FastAPI & Python 3.11 backend service
Local PostgreSQL 14+ database storage
Encrypted credential storage with Windows DPAPI
Live Monitor, Shifts & Reports
03

Web Dashboard

Modern web dashboard displaying the live punch feed, department metrics, rotational and overnight shift patterns, overtime rules, and automated CSV/PDF report exports.

Live attendance monitor and punch stream
Rotational, overnight, split and flex shifts
Scheduled daily CSV and PDF report export
Web-Based ESS & Approvals
04

Self-Service Portal & Reports

Mobile-friendly browser portal for employees to review personal timesheets, check attendance logs, and submit leave requests or shift swaps.

Personal timesheet & attendance history
Leave requests and shift swap submissions
Payroll calculation from verified attendance hours
CORE PLATFORM PILLARS

Four Pillars of PRESENCE OS

Engineered for enterprise terminal management, automated shift rules, and verified on-premise attendance.

PILLAR 01Terminal Sync

Terminals and biometric sync

Connects with ZKTeco terminals over the ADMS (ICLOCK) push protocol, providing real-time punch capture and remote hardware sync.

Connects with ZKTeco terminals over the ADMS (ICLOCK) push protocol
Real-time punches pushed from terminal to on-premise gateway
Remote device commands (reboot, time sync) and biometric template sync (supported models)
Terminal connection status: online/offline monitoring and heartbeat tracking
PILLAR 02Shifts & Analytics

Attendance, shifts and analytics

Comprehensive live monitor and analytics engine with customizable shift patterns, overtime logic, and daily export schedules.

Live attendance dashboard and real-time punch event feed
Rotational, overnight, split and flexible shifts with customizable grace rules
Late arrival, early departure, and overtime calculation rules
Department attendance, weekly trends, and month-to-date analytics
Scheduled daily CSV and PDF report generation
PILLAR 03Payroll & ESS

Payroll and employee self-service

Direct payroll calculations from verified attendance hours alongside a mobile-friendly web portal for employee requests.

Payroll preparation: calculated work hours, overtime totals, deductions, and exportable timesheets
Employee Self-Service portal: personal attendance log, timesheets, and leave request submission
Personnel directory with department organization and onboarding records
PILLAR 04Access & Governance

Access control and administration

Hardware access control groups, door timezone schedules, granular role-based permissions, and immutable administrative audit logs.

Role-based access control (Super Admin, Admin, HR, Finance, Employee)
Immutable audit logs tracking manual punch edits, shift changes, and administrative actions
Door access groups and holiday timezone schedules (for compatible access controllers)
REST API and webhook endpoints for custom external systems and database exports
FOR IT TEAMS

Under the Hood

Technical specifications for system administrators and deployment engineers.

BACKEND
Python 3.11, FastAPI
DATABASE
PostgreSQL 14+ with automatic migrations
FRONTEND
React, TypeScript, Vite
DEVICE PROTOCOL
ZKTeco ADMS (ICLOCK) HTTP push & standalone protocol (TCP/UDP port 4370)
SECURITY & ENCRYPTION
Role-based access control, encrypted credential storage using Windows DPAPI, audit log
LICENSING
Firebase cloud licensing with an offline grace period

License checks transmit only organization ID and subscription token. Attendance records remain on-premise, and operations continue uninterrupted during internet outages under an offline grace period.

INSTALLATION & REQUIREMENTS
Guided Windows installer that sets up PostgreSQL and runs database migrations

Runs on Windows Server 2016+ or Windows 10/11 Pro (64-bit). Terminals must be network-routed to the ADMS gateway server port.

WORKFLOW COMPARISON

PRESENCE OS vs Manual Attendance Workflows

How modern push synchronization compares to legacy manual processes.

Interface
Legacy: Desktop-only tools
PRESENCE OS: Web dashboard
Data from devices
Legacy: Manual USB export or polling
PRESENCE OS: Push sync over ADMS
Payroll inputs
Legacy: Spreadsheet calculation
PRESENCE OS: Payroll calculation from attendance hours
Data location
Legacy: Depends on the tool
PRESENCE OS: On your own server
Setup
Legacy: Manual
PRESENCE OS: Guided installer

* Comparison reflects typical manual workflows, not any specific product.

PRESENCE OS FAQ

Frequently Asked Questions

PRESENCE OS works with ZKTeco biometric terminals that support the ADMS (ICLOCK) push protocol (including popular SpeedFace, SilkBio, MB, and uFace series). Contact our engineering team with your model and firmware details to confirm setup.

Ready to Connect Your ZKTeco Terminals?

Schedule a dedicated walkthrough to see how PRESENCE OS turns raw biometric punches into structured attendance and access management.

ZKTeco is a registered trademark of its respective owner. PRESENCE OS is an independent software product and is not affiliated with, sponsored by, or endorsed by ZKTeco.

PRESENCE OS