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

Reading the Door Status (Front Desk)¶

The Status screen is the one most front-desk staff use during the day. At the top is a large colored indicator showing the current door state:

State	Color	What it means
LOCKED	Red	The door is secured. Members need a valid scan (or an open schedule window) to get in.
TEMPORARILY UNLOCKED	Orange	The door just granted access and will re-lock automatically after a few seconds (a countdown shows how long is left).
UNLOCKED	Green	The door is intentionally held open — usually a door-open schedule window, or someone unlocked it manually.
UNKNOWN STATE	Gray	DFACS can't confirm the door's actual state (usually a relay communication hiccup). Treat the door as unsecured until it clears.

The page refreshes on its own every couple of seconds; use Refresh Status for an up-to-the-second read.

A large red FAIL-SAFE MODE ACTIVE banner is a deliberate safety feature, not a malfunction. DFACS unlocks the door automatically rather than risk trapping someone if the door computer itself is under heavy strain (for example, if it is running out of resources). It re-locks itself once conditions return to normal. You don't need to do anything — but if it appears repeatedly in the same day, mention it to your manager or support. (This software fail-safe is about the computer's health, not building power — see FAQ for the power-outage question.)

Manual Door Controls¶

Below the indicator are three buttons:

Open Door — momentarily unlocks the door, same as a valid scan; it re-locks after the normal unlock duration.
Lock — forces the door locked right now.
Unlock — forces the door unlocked and holds it open until someone locks it again (or a schedule takes over).

If a click is rejected with a message like "Schedule does not allow this action right now," an active door schedule is blocking manual control at that moment — check with a manager if the schedule needs adjusting (see Managing Schedules).

When the Internet Is Down¶

The door keeps working when the internet or your membership platform is down. DFACS validates scans against its local copy of allowed members, and new check-ins queue up and sync automatically once the connection returns. Don't manually override the door into an unlocked state because of an outage — normal scan-based access continues to work.

When to Call Support¶

Contact DragonFly support (or your facility's IT contact) if you see:

The indicator stuck on UNKNOWN STATE for more than a few minutes.
The FAIL-SAFE MODE banner appearing repeatedly in the same day.
The barcode scanner not reading any cards/tags at all (try the Troubleshooting scanner checks first).
A member with a valid membership consistently denied for a reason that doesn't match their actual account status.
The web page itself won't load on the door computer.

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 DragonFly Cloud Portal
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 Barcode Reader)

Integration

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

Network

Network settings are configured by DragonFly during installation. Contact support before changing them.

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.