Documentation

Everything you need to know about using Camera Hub.

Welcome to Camera Hub

Camera Hub is a centralized platform for monitoring and managing security camera systems across multiple sites. It gives you real-time visibility into camera status, device health, and site activity from a single dashboard.

Logging In

Navigate to the login page and enter your username and password. If your organization uses email verification, you must verify your email address before you can log in.

  • Use the "Remember me" option to stay signed in for up to 30 days
  • If you forget your password, use the "Forgot your password?" link to reset it via email
  • After 24 hours of inactivity your session will expire automatically

Navigating the Dashboard

After logging in, you'll land on the Explorer — your main workspace. The interface is organized into:

  • Sidebar — Lists your assigned sites with color-coded status dots and quick-access search
  • Main panel — Shows cameras, devices, and details for the selected site with tabbed navigation (Overview, Devices, Cameras, Logs, Settings)
  • Header — Contains site search, real-time notification bell, and your profile menu

Real-Time Updates

The dashboard updates automatically in real time using server-sent events (SSE). When camera data changes, the UI refreshes instantly without any manual action.

  • Instant updates — Camera status changes appear as soon as they are detected by the backend
  • No polling overhead — The server pushes updates only when data changes

Updates automatically pause when your browser goes offline and resume when connectivity is restored.

Understanding Site Status

Each site in the sidebar displays a color-coded status dot that summarizes its overall health at a glance:

OPERATIONAL

All devices connected and all cameras online.

ISSUES DETECTED

One or more cameras are offline, but all devices are still reachable.

CRITICAL

One or more devices are disconnected and cannot be reached.

Quick Start Checklist

  • Log in with your credentials
  • Explore the sidebar to see your assigned sites
  • Click a site to view its cameras and devices
  • Check camera status indicators (green = online, red = offline)
  • Click a camera thumbnail to view its full-size snapshot
  • Review your profile settings and update your password if needed

What Is a Site?

A site represents a physical location where cameras and network devices are installed — such as an office building, warehouse, retail store, or data center. Sites are the primary organizational unit in Camera Hub.

Adding a Site

Users with the manage_sites permission can add new sites. To add a site:

  • Click the "Add Site" button in the sidebar or header
  • Enter the site name, address, city, state, and zip code
  • Add one or more contacts for alert notifications
  • The site will appear in your sidebar immediately

Tip: Your plan tier determines how many sites you can create. Check the Plans & Billing tab for your current limits.

Editing & Deleting Sites

Open a site's Settings tab to update its name, address, or configuration. Deleting a site is a destructive action that permanently removes:

  • The site record and all its settings
  • All devices belonging to the site
  • All cameras discovered on those devices
  • All camera notes, reports, and snapshot images
  • All device and camera logs
  • All site contacts, notes, links, and maps
  • All camera group assignments

This action cannot be undone. You will be asked to confirm before proceeding.

Site Maps

Each site can display a map in the Overview tab. Two map modes are supported:

  • Google Maps embed — Paste a Google Maps embed URL to show an interactive map
  • Uploaded image — Upload a site map, floor plan, or camera layout image

Configure maps from the site's Settings tab under General settings. Requires the manage_sites permission.

Site Contacts

Each site can have one or more contacts — people responsible for on-site operations. Contacts include a name, email, and phone number. Users with the manage_site_contacts permission can add, edit, or remove contacts.

Contacts can be configured with the following roles:

  • Email alerts — Receives alert emails when cameras or devices go offline
  • Primary contact — The first person contacted during incidents (one per site)
  • Secondary contact — Backup contact if the primary is unavailable (one per site)
  • Daily report — Receives daily camera health report emails

Alert Interval

Each site has a configurable alert interval that controls how often Camera Hub checks for and sends alert emails. The default is 60 minutes. You can adjust this from the site's Settings tab to balance between timely alerts and notification fatigue.

Site Notes & Links

Attach notes to a site for internal documentation — such as access instructions, network diagrams, or maintenance schedules. You can also add external links to relevant resources. These require the manage_site_notes and manage_site_links permissions respectively.

What Is a Device?

A device is a network video recorder (NVR), digital video recorder (DVR), server, or gateway that manages cameras at a site. Devices connect to the camera platform and provide the interface for camera monitoring. Each device belongs to a single site.

Supported Platforms

Camera Hub supports five camera management platforms:

Axxon

Enterprise VMS with clustering support. Configure up to 5 server IPs per device for high-availability setups. Monitors individual server node health.

Avigilon

Video management system with session-based authentication. Supports camera discovery and status monitoring.

Dahua

Wide range of NVRs, DVRs, and IP cameras. Supports both IP and coaxial (analog) cameras with automatic channel detection.

Uniview

Network video recorders with REST API integration. Tracks camera serial numbers, MAC addresses, and display IDs.

TVT

NVRs and DVRs with HTTP API. Supports channel enumeration with automatic camera name and status discovery.

Adding & Managing Devices

Users with the manage_devices permission can add, edit, and delete devices. When adding a device:

  • Select the target site and camera platform
  • Enter the device hostname or IP address, port, and credentials
  • Optionally set a device type label (e.g., NVR, DVR, Server) to categorize your hardware
  • Set the scan interval (how often Camera Hub checks camera status)
  • For Axxon devices, you can configure up to 5 server IPs for cluster setups

Device credentials are encrypted at rest using AES-256-CBC encryption and are never visible in the interface after saving.

Device Monitoring

Camera Hub periodically connects to each device to scan camera status. The scan interval is configurable per device (from 5 minutes to 24 hours). You can see the last scan time and next scheduled scan on the device card.

If a device becomes unreachable, its status changes to disconnected and the site status escalates to CRITICAL. An alert email is sent automatically and a recovery email follows when the device comes back online.

Time Drift Detection

Camera Hub monitors the clock on each device and alerts you if it drifts more than 60 seconds from the server time. Time drift can cause issues with video recording timestamps and evidence integrity. Drift alerts appear in the site logs.

Camera Overview

Cameras are automatically discovered when Camera Hub scans a device. Each camera shows its current status (online or offline), name, IP address, and the server it's connected to. Cameras are grouped by site and device.

You can switch between grid view (thumbnail cards) and list view (compact table) using the toggle at the top of the camera panel. Your preference is saved automatically.

Camera Detail View

Click any camera thumbnail or name to open the camera detail view. This provides a full set of tools for that camera:

  • Full-size image — View the camera's latest snapshot at full resolution
  • Snapshot history — Browse archived monthly snapshots with a timeline slider
  • Refresh snapshot — Capture a live image directly from the camera
  • Download image — Save the current snapshot to your computer
  • Criticality toggle — Mark the camera as critical or non-critical
  • Manual Disconnect — Mark the camera as intentionally offline (Dahua, Uniview, TVT)
  • Camera groups — Assign the camera to location or power source groups
  • Ping — Test network connectivity to the camera
  • Notes — View note history and add new notes
  • Logs — View event logs specific to this camera

Available actions depend on your permissions and the camera's platform.

Status Monitoring

Camera statuses are checked at each scan interval. The dashboard uses color-coded indicators:

  • Green glow — Camera is online and responding
  • Red glow (pulsing) — Camera is offline or unreachable

When a camera goes offline, a log entry is created automatically. When it comes back online, a recovery log is added. The dashboard updates in real time to keep status indicators current.

Camera Thumbnails & Snapshots

Camera Hub automatically captures thumbnail images from each camera during scans. Thumbnails are displayed on camera cards in grid view, giving you a visual preview of each camera's feed.

  • Click a thumbnail to open the camera detail view with the full-size image
  • Download snapshots using the download button on camera cards
  • Refresh a snapshot on demand by clicking the refresh button — this captures a live image directly from the camera (rate-limited to once per hour per camera)
  • Timestamp — Each snapshot shows when it was captured so you know how recent the image is

When a camera goes offline, its last known image is preserved so you always have a recent reference.

Snapshot History

Camera Hub archives camera snapshots monthly so you can review how a camera's view has changed over time. To access snapshot history:

  • Click a camera to open its detail view
  • Click the "Load History" button
  • Use the timeline slider to browse through previous snapshots
  • Click any historical snapshot to view it full-size

Snapshot history is retained for up to 12 months. This is useful for verifying camera placement, detecting tampering, or reviewing how environmental conditions affect camera views.

Manual Disconnect

Sometimes a camera is intentionally taken offline for maintenance or relocation. Use the Manual Disconnect feature to mark a camera as intentionally disconnected. Manually disconnected cameras:

  • Are excluded from site status calculations (won't trigger "Issues Detected")
  • Do not generate alert emails
  • Are visually distinguished in the camera list

This feature is available for Dahua, Uniview, and TVT cameras.

Camera Groups

Organize cameras within a site by creating groups. Groups help you categorize cameras by their physical location or infrastructure dependency. Two group types are available:

  • Location — Group cameras by where they are (e.g., "Front Entrance", "Parking Lot", "Server Room")
  • Power Source — Group cameras by their power infrastructure (e.g., "UPS-1", "Generator A", "Main Panel")

Camera groups require the manage_camera_groups permission. A single camera can belong to both a location group and a power source group.

Criticality Flags

Mark cameras as critical to highlight them for priority attention. Critical cameras are visually distinguished in the dashboard and are called out separately in alert emails so your team can focus on the most important feeds first. Requires the update_cam_criticality permission.

Camera Notes

Add notes to individual cameras to track maintenance, known issues, or configuration details. Camera notes maintain a full history — when you add a new note, previous notes are preserved as a timeline. Each note records who wrote it and when. Requires the manage_cam_notes permission.

Camera Reports

Reports are different from notes — they are formal incident submissions used to flag a camera problem requiring attention. When you submit a report:

  • You can select multiple offline cameras to include in a single report
  • Reports are visually flagged with a red indicator to distinguish them from regular notes
  • A log entry with the appropriate severity is created automatically
  • Reports serve as an audit trail for camera incidents

Use notes for informal annotations (reminders, config details). Use reports for formal incident documentation. Requires the submit_cam_reports permission.

Search & Filtering

Use the search bar to filter cameras by name, IP address, or status. You can also filter to show only online or offline cameras. The search works across all camera platforms.

Ping

Use the ping feature to test connectivity to a specific camera's IP address on demand. This helps diagnose network issues without waiting for the next scan cycle. Requires the ping_cameras permission.

CSV Export

Camera Hub supports two types of CSV exports for each site:

  • Camera & Device export — Includes camera names, IP addresses, status, platform, device names, and server information
  • Log export — Includes event logs with timestamps, severity, camera names, and event details (supports date range filtering)

Both exports require the export_data permission. Each export action is recorded in the audit log.

Alerts Overview

Camera Hub proactively monitors your camera infrastructure and notifies you when issues arise. Alerts are delivered through multiple channels to ensure you never miss a critical event.

Email Alerts

When cameras go offline or devices become unreachable, Camera Hub sends alert emails to the site's configured contacts. Alert emails include:

  • Camera alerts — Lists which cameras went offline, with their names, IPs, and platform
  • Device alerts — Notifications when an NVR/DVR becomes unreachable
  • Server node alerts — For Axxon clusters, alerts when individual server nodes go down
  • Time drift alerts — Warnings when a device clock drifts more than 60 seconds
  • Recovery alerts — Notifications when a previously offline device comes back online

Critical cameras are highlighted separately in alert emails so your team can prioritize accordingly.

Tip: Alert frequency is controlled by each site's alert interval (default: 60 minutes). Adjust this in the site's Settings tab to avoid notification fatigue.

Real-Time Notifications

The notification bell in the header provides real-time updates without waiting for email. Notifications stream live to your browser and appear instantly when:

  • Cameras go offline or come back online
  • Devices become disconnected or reconnect
  • Server nodes report issues

Each notification shows a severity badge (Critical, Warning, or Info) and a type badge (Camera, Device, or System) so you can quickly assess what happened. Unread notifications are indicated by a count badge on the bell icon. Click the bell to view the last 24 hours of notifications and mark them as read.

Desktop Notifications

Enable desktop (browser) notifications to receive pop-up alerts even when the Camera Hub tab isn't in focus. To enable:

  • Click the notification bell in the header
  • Toggle on Desktop Notifications
  • Allow notifications when your browser asks for permission

Desktop notifications show the camera or device name, the event type, and the site name. You can disable them at any time from the same notification panel.

Daily Health Reports

Camera Hub can send automated daily camera health reports that summarize the past 24 hours of activity for each site. Reports include:

  • Camera online/offline counts broken down by platform
  • Critical camera status
  • Notable events and log entries from the past 24 hours
  • An AI-generated summary highlighting key issues and trends

To receive daily reports, a site contact must be opted in via the Daily Report toggle in the site's contact settings. Reports are sent once per day during the configured report hour.

Configuring Alerts

Alert settings are managed at the site level. To configure who receives alerts:

  • Go to the site's Settings tab, then Emails
  • Add contacts with their email addresses
  • Toggle Email Alerts on for contacts who should receive offline/online notifications
  • Toggle Daily Report on for contacts who should receive the daily health summary
  • Designate one Primary and optionally one Secondary contact

Requires the manage_site_contacts permission.

User Management

Organization admins can manage users from the Admin panel. You can add new users by sending email invitations, assign them to specific sites, and set their role.

  • Invitations are sent via email and expire after 7 days
  • Invited users set their own username and password upon acceptance
  • Users can be assigned to one or more sites to control their access
  • User accounts can be managed (role changes, site assignments) at any time
  • Permission changes take effect in real-time — the dashboard automatically detects updates

Invitation Flow

Here's how the user invitation process works from start to finish:

  1. 1. Admin sends invite — From the Admin panel, enter the new user's email, select their role, and send the invitation
  2. 2. User receives email — An email with a secure invitation link is sent to the new user
  3. 3. User clicks the link — The link opens the account setup page (links expire after 7 days)
  4. 4. User creates account — They choose a username and password that meets the password policy
  5. 5. Account is ready — The user is automatically assigned to the organization with the pre-selected role and can log in immediately
  6. 6. Admin assigns sites — The admin can then assign the user to specific sites from the site Settings tab

Role Hierarchy

Camera Hub uses a role-based access control system with six built-in roles:

Role Description Scope
Superadmin Full system access across all organizations Global
Org Admin Manage users, sites, and settings within the organization Organization
Admin Manage sites and devices across assigned locations Assigned Sites
IT Tech Technical operations, camera testing, and reporting Assigned Sites
Tech View cameras and submit reports Assigned Sites
Customer Read-only access to view assigned sites Assigned Sites

Custom Roles

Organizations on Professional and Enterprise plans can create custom roles with granular permissions. Custom roles let you tailor access levels to your team's specific needs. Create and manage custom roles from the Roles & Permissions tab in the Admin panel.

Permissions Reference

Camera Hub supports 20 granular permissions that can be assigned to custom roles:

Permission Description
Cameras
view_camerasView camera lists and status
manage_cam_notesAdd, edit, and delete camera notes
update_cam_criticalityMark cameras as critical or non-critical
ping_camerasPing camera IP addresses on demand
submit_cam_reportsSubmit formal camera issue reports
view_camera_logsView camera and device event logs
manage_camera_groupsCreate and manage camera groups (location and power source)
Sites
view_sitesView site lists and details
manage_sitesCreate, edit, and delete sites
manage_site_notesAdd, edit, and delete site notes
manage_site_contactsManage site contact information and alert settings
manage_site_linksAdd and remove site reference links
Devices
view_devicesView device lists and configurations
manage_devicesAdd, edit, and delete devices
Users
view_usersView user lists in your organization
manage_usersInvite, edit, and remove users
Administration
access_admin_panelAccess the admin management panel
view_audit_logsView system audit logs
export_dataExport data to CSV files

Audit Log Overview

Camera Hub maintains a comprehensive audit trail of all user actions. Every login, data change, export, and administrative action is recorded with the user, timestamp, IP address, and details.

Viewing Audit Logs

Users with the view_audit_logs permission can browse the audit trail from the Admin panel. Logs can be filtered by:

  • Action type (create, update, delete, login, export, etc.)
  • User who performed the action
  • Organization
  • Date range

Exporting Logs

Audit logs can be exported to CSV format for compliance, archival, or external analysis. Exporting requires the export_data permission. Each export is itself audit-logged.

Device & Camera Logs

Separate from audit logs, Camera Hub tracks device and camera events — when a camera goes offline, when it comes back online, server node issues, and time drift warnings. These logs are stored per-site and can be viewed from the Explorer's Logs tab. Requires the view_camera_logs permission.

Log Severity Levels

Each log entry has a severity level that indicates the nature and urgency of the event:

INFO

Routine events: cameras coming online, scans completing, or configuration changes.

WARNING

Non-critical issues: time drift detected, degraded performance, or partial connectivity.

CRITICAL

Serious problems: cameras going offline, devices unreachable, or server nodes down.

CLEAR

Recovery events: a previously reported issue has been resolved (camera back online, device reconnected).

Use the severity filter dropdown in the Logs tab to focus on specific event types.

Filtering & Searching Logs

The Logs tab provides several tools for finding specific events:

  • Severity filter — Show only Info, Warning, Critical, or Clear events
  • Date range — Filter logs to a specific start and end date
  • Text search — Search within log messages for camera names, IPs, or keywords
  • Column sorting — Click column headers (Time, Severity, Node Name, Camera Name, Data) to sort
  • Archive toggle — Enable "Use Archive" to search older logs that have been archived past your plan's retention period

Logs can also be exported to CSV using the Export button. Requires the export_data permission.

Log Retention

Log retention periods vary by plan tier:

Plan Device/Camera Log Retention
Free Trial 7 days
Professional 30 days
Enterprise 365 days

Logs beyond the retention period are automatically archived. System audit logs are retained for 365 days across all plans.

Plan Tiers

Camera Hub offers three plan tiers to fit organizations of every size:

Free Trial

$0 / 30 days

  • Up to 3 sites
  • Up to 50 cameras
  • Up to 3 users
  • 7-day log retention

Professional

$10 / 16 cameras / mo

  • Unlimited sites
  • Unlimited cameras
  • Unlimited users
  • 30-day log retention
  • Custom roles
  • Volume discounts

Enterprise

Custom pricing

  • 500+ cameras
  • Unlimited everything
  • 365-day log retention
  • Custom roles
  • Dedicated support

Volume Discounts

Professional plan customers receive automatic volume discounts as they scale:

Camera Count Discount
1 – 128 cameras Standard pricing
129 – 256 cameras 5% off
257+ cameras 10% off

Tip: Discounts apply once you exceed the threshold. For example, at 129 cameras the 5% discount kicks in on your total.

Free Trial & Expiry

New organizations start with a 30-day free trial. When your trial expires:

  • Access to the dashboard is blocked
  • You are redirected to the trial expiry page with upgrade options
  • Your data is preserved for a grace period before purging
  • Upgrade to Professional or Enterprise to restore full access immediately

Upgrading Your Plan

To upgrade from a Free Trial, contact your organization administrator or use the upgrade options on the trial expiry page. Organization admins with superadmin access can change plans from the Admin panel.

Profile Settings

Access your profile settings from the dropdown menu in the top-right corner of any page. From your profile you can:

  • Update your first and last name
  • View your email address and role
  • Change your password

Password Policy

All passwords must meet the following requirements:

  • Minimum 8 characters
  • At least one uppercase letter
  • At least one lowercase letter
  • At least one number
  • At least one special character

Passwords are securely hashed and never stored in plain text.

Email Verification

New accounts require email verification before full access is granted. A verification link is sent to your registered email address. If you don't receive the email, you can request a new verification link from the login page.

Password Reset

If you've forgotten your password, you can reset it without contacting an administrator:

  1. Go to the login page and click "Forgot your password?"
  2. Enter the email address associated with your account
  3. Check your inbox for a password reset email (check spam/junk if needed)
  4. Click the secure reset link in the email
  5. Choose a new password that meets the password requirements
  6. Log in with your new password

Reset links are single-use and expire after a limited time for security. If the link has expired, request a new one.

Session Timeout

For security, your session will automatically expire after 24 hours of inactivity. When your session expires, you'll be redirected to the login page. Use the "Remember me" option during login to extend your session for up to 30 days.

Signing Out

To sign out, click your profile icon in the top-right corner and select "Sign Out." This immediately ends your session and clears any stored session data. You'll be redirected to the login page.

Frequently Asked Questions

A site shows CRITICAL (red) when one or more of its devices are disconnected — meaning Camera Hub cannot reach the NVR/DVR at all. This is more severe than individual cameras being offline. Check the device's network connectivity, power supply, and that the IP address and port are correct.
This means Camera Hub can reach the NVR/DVR but the individual camera is reporting as offline. Common causes include: the camera lost power, its network cable was disconnected, the camera IP address changed, or the camera is physically damaged. Use the Ping feature to test connectivity directly.
Use the Manual Disconnect feature to mark the camera as intentionally offline. This excludes it from status calculations and alert emails. Manual Disconnect is available for Dahua, Uniview, and TVT cameras. You can re-enable the camera at any time when it's back in service.
The scan interval is configured per device when you add it. Options range from every 5 minutes to every 24 hours. You can change this at any time from the device settings. The dashboard updates in real time to reflect the latest scan results.
Yes. Click the refresh button on any camera card to capture a live snapshot directly from the camera. This works independently of the scheduled scan cycle and gives you the most up-to-date image. The snapshot may take a few seconds to load depending on the camera's response time.
When your free trial expires, dashboard access is blocked but your data is preserved for a grace period. During this time, you can upgrade to Professional or Enterprise to restore full access immediately. After the grace period, your data will be permanently purged and cannot be recovered.
Go to the site's Settings tab, then Emails. Add a contact (or use an existing one) and toggle on the "Daily Report" option. That contact will receive a daily email summarizing the site's camera health over the past 24 hours, including an AI-generated analysis of any issues.
Camera groups help you organize cameras within a site by location (e.g., "Lobby", "Parking Lot") or by power source (e.g., "UPS-1", "Generator A"). This makes it easier to identify which cameras are affected when there's a power outage in a specific area or to quickly find cameras in a particular part of a building.
Notes are informal annotations you add to a camera — maintenance reminders, configuration details, or known issues. They're for your team's reference. Reports are formal incident submissions that flag a camera problem requiring attention. Reports are visually flagged with a red indicator, create a log entry with severity, and serve as an audit trail for camera incidents. Notes require the manage_cam_notes permission; reports require submit_cam_reports.
Yes. On-demand snapshot refresh is rate-limited to once per hour per camera. This prevents overloading the camera hardware with repeated capture requests. If you need to see the latest image, wait for the next scheduled scan or try again after the cooldown period.
Yes. Click the notification bell in the header and enable the desktop notifications toggle. Once enabled, your browser will show pop-up notifications for camera and device status changes even when the Camera Hub tab isn't in focus. You can disable this at any time from the same notification panel.
On the login page, click "Forgot your password?" and enter your email address. You'll receive an email with a secure reset link. Click the link, set a new password that meets the password requirements, and you'll be able to log in immediately. Reset links expire after a limited time for security.
Info — Routine events like cameras coming online or scans completing. Warning — Non-critical issues like time drift or degraded performance. Critical — Serious problems requiring immediate attention, such as cameras going offline or devices becoming unreachable. Clear — Recovery events indicating a previously reported issue has been resolved.
Deleting a site permanently removes: the site record, all devices belonging to the site, all cameras discovered on those devices, all camera notes and reports, all device and camera logs, all site contacts, site notes and links, site maps, and camera group assignments. This action cannot be undone. You will be asked to confirm before proceeding.
Yes. Click a camera to open its detail view, then use the "Load History" button to browse previous snapshots. Camera Hub archives snapshots monthly, so you can see how a camera's view has changed over time. Snapshot history is retained for up to 12 months.