Skip to content

Dashboard Guide

The DFACS web dashboard is your control center for monitoring access, reviewing logs, and configuring the system.

Access the dashboard from any browser on your local network: https://<dfacs-device-ip>


Dashboard Overview

The main dashboard shows the current system state at a glance:

Panel What It Shows
System Status API connection, sync status, offline/online indicator
Relay Status Current lock state (LOCKED / UNLOCKED), door sensor state
Occupancy Real-time count (if RTE sensors are installed)
Recent Activity Last few access events (granted / denied)
Member Count Total members in local database

Access Logs

Dashboard → Access Logs

Shows every scan event with:

  • Timestamp — date and time of the scan
  • Barcode — the scanned barcode value
  • Result — GRANTED or DENIED
  • Reason — why access was denied (if applicable): expired membership, unknown barcode, suspended account, etc.
  • API Response — confirmation that the check-in was sent to your gym software

Filtering Logs

Use the filter controls to narrow results by:

  • Date range
  • Result (Granted / Denied)
  • Reason code

Exporting Logs

Click Export to download access logs as a CSV or Excel file for reporting.


Check-in Queue

Dashboard → Check-in Queue

Shows check-ins that are queued to be sent to your gym software. In normal operation this is empty — check-ins are sent immediately. When DFACS is offline, pending check-ins accumulate here and are processed when connectivity is restored.


Statistics

Dashboard → Statistics

Visual charts showing access patterns over time. Available time ranges:

  • Last 24 hours
  • Last 7 days
  • Last 30 days
  • Last 12 months
  • Year to date

Charts include total scans, grant rate, denial breakdown by reason, and peak access times.


Barcode Database

Dashboard → Barcode Database

Browse the locally cached member database. Shows all barcodes DFACS knows about, their current status, and the last sync time.

Note

This is a read-only view of the local cache. To add or remove members, make the change in your gym management software — DFACS will sync the change on the next sync interval.


Denied Barcodes

Dashboard → Denied Barcodes

A list of barcodes that have been denied access and the reason. Useful for identifying members with account issues or unknown barcodes that may need to be added.


Access Schedules

Dashboard → Access Schedules

Create and manage timed door schedules. See Managing Schedules for full details.


Configuration

Dashboard → Configuration

All system settings. Protected by a password (default: admin — change this on first setup).

Key Settings

System

  • Friendly Name — the name this device appears as on your network and in DFACSWAN
  • Debug Level — logging verbosity (INFO for normal operation, DEBUG for troubleshooting)
  • Log Retention — how many days of logs to keep

Hardware

  • Relay Type — DragonFly / ABC / Dumb
  • Relay COM Port — serial port for the relay controller
  • Unlock Duration — seconds the door stays unlocked per scan
  • Scanner COM Port — serial port for the barcode scanner (leave blank for USB HID)

Integration

  • Billing Platform — your gym software selection
  • API credentials for the selected platform
  • Sync interval settings

Network

  • Web Server Port — default 443 (HTTPS)
  • Zeroconf — enable/disable automatic network discovery

Security

  • Configuration Password — change this from the default immediately
  • PII Display — control whether member names appear in logs

Error Log

Dashboard → Error Log

System errors and warnings. Check here first when troubleshooting unexpected behavior.


System Tray Console

The DFACS system tray icon (DragonFly logo in the Windows taskbar) provides quick access to:

  • Show/Hide Console — a live log window with color-coded messages
  • Open Web GUI — launches the dashboard in your browser
  • Open Logs — opens the log file directory
  • Exit — stops DFACS (members will not be able to scan in)

The console log can be filtered by severity level (DEBUG / INFO / WARNING / ERROR / CRITICAL) using the checkboxes at the top of the window.