---
title: "Avigilon"
source: /gcxone/devices/avigilon
locale: en
updated: 2026-09-14
---
## Summary

This documentation provides a comprehensive guide for integrating **Avigilon** Video Management System (VMS) with the **GCXONE** platform for enhanced video surveillance and analytics.

**Purpose:** Configure Avigilon Video Management System (VMS) to integrate seamlessly with GCXONE platform for enhanced video surveillance and analytics.

**Outcome:** Enhanced functionality with analytics, user management, and alarm configuration enabling robust management and monitoring capabilities through GCXONE integration.

**Audience:** System administrators / IT professionals / Field engineers.

## Prerequisites

Before starting the integration, ensure the following are available:

- Avigilon ACC client software
- ACC 7 Web Endpoint Service
- IT team responsible to set up port forwarding on their firewall or router
- Administrative access to Avigilon system

## Avigilon Configuration

Device Profile

- **Type:** Video Management System (VMS)
- **Discovery:** WebAPI Endpoint
- **Events:** Motion detection, analytic events, alarm triggers
- **Ports:** Custom (configured via port forwarding)
- **Known quirks:** Requires WebAPI Endpoint installation for external communication. User group setup mandatory for GCXONE access. Analytics configuration at camera level needed for event detection.
- **Live:** Supported
- **Analytics:** Supported (Motion Detection, Object Detection)
- **Alarm Management:** Supported
- **User Management:** Supported
- **PTZ Controls:** Supported

## Avigilon ACC Client Setup

### Step 1 — Install Essential Software Components

Install WebAPI Endpoint

In case of having Avigilon VMS, install the WebAPI Endpoint by following the instructions provided in the Avigilon WebAPI Endpoint Quick Start Guide. This endpoint facilitates communication between the VMS and external applications.

Ensure ACC Server Accessibility

Confirm that the ACC (Avigilon Control Center) server is properly installed and operational. The ACC server communicates with the external world through the configured server port, ensuring that the VMS can send and receive data as needed.

**Expected result:** WebAPI Endpoint installed and ACC server accessible.

### Step 2 — Login to Avigilon ACC Client

UI path: ACC Client → Login

In the ACC client login screen, locate the field to enter the device's IP address in the search bar. Enter your username and password for the ACC client.

![An Avigilon client view with the camera tree highlighted on the left and four empty panes carrying the Avigilon mark.](/api/media/file/3519fd67705ad4eb1a43f5a871149abc4eaa4b84-1893x1002.png)

**Expected result:** Successfully logged into ACC client.

### Step 3 — Navigate to Camera Configuration

UI path: ACC Client → Camera Selection

Once logged in, use the client interface to navigate to the specific camera or device you need to configure.

![](/api/media/file/e9bcefb4fad21cc76534a5b589c6aa12dc9ae7d9-1893x1002.png)

**Expected result:** Camera interface accessible for configuration.

### Step 4 — Access Camera Setup

UI path: Camera → Right-Click → Setup

- Right-click on the camera you want to configure
- In the context menu that appears, click on **Setup**
- This will open the camera's configuration page

![A camera's settings menu with the Analytics group highlighted — settings, motion detection, analytic events and teach by example — between the video and links groups.](/api/media/file/3668b067b3fcdcfefba266bd768ece1c3a00ef77-1437x711.png)

![](/api/media/file/ab7c1a85d051b6e281af4a0f8d427897fb0f6454-1217x687.png)

**Expected result:** Camera configuration page opened.

### Step 5 — Configure Motion Detection Analytics

UI path: Camera Setup → Analytics → Motion Detection

Choose and configure the type of analytics. After selecting the desired analytics type, you will be able to adjust various settings and parameters specific to that type.

Configure Motion Detection parameters:

- **Object Types:** Select types of objects (Person, Vehicle)
- **Sensitivity:** Set sensitivity level (recommended 8–10)
- **Threshold Time:** Set minimum duration (recommended 2 seconds)
- **Pre-Motion Record Time:** Set recording time before event (recommended 10 seconds)
- **Post-Motion Record Time:** Set recording time after event (recommended 10 seconds)

![](/api/media/file/82c26863c1bed996de1ce10943ce62945fbf7557-838x773.png)

**Expected result:** Motion detection analytics configured.

### Step 6 — Configure Analytic Events

UI path: Camera Setup → Analytics → Analytic Events

Analytics process the video feed in real-time to detect and respond to specific activities or conditions.

- Click on the button **Add**
- Define your Area of Interest by clicking the icon on the top left of the screen

![](/api/media/file/97c409b3c610af965b3f867a2847787d6f967df4-540x182.png)

Configure Event Parameters

After you add the area of interest, setup the following:

- **Enabled Checkbox:** Check to enable the analytic event
- **Activity:** Select the type of activity to monitor within the defined zone
- **Object Types:** Specify what kinds of objects the system should detect
- **Sensitivity:** Set sensitivity level (recommended 8–10)
- **Threshold Time:** Set minimum duration (recommended 2 seconds)
- **Number of Objects:** Specify number of objects required to trigger event
- **Timeout:** Set wait time before resetting (recommended 10 seconds)
- **Distance (feet):** Set minimum distance an object must travel

![The Add/Edit Analytics Events dialog with a red detection zone drawn over the camera view and the settings panel highlighted — activity, object types, sensitivity, object count, threshold time and timeout.](/api/media/file/2d1854783c1ce3454c6f88aa54cfb26c198b2458-1521x855.png)

**Expected result:** Analytic events configured with area of interest.

### Step 7 — Setup User Group for GCXONE

UI path: Site → Right-Click → Setup → User and Groups

- Right-click on the Site you want to configure

![A site tree with its context menu open and Setup highlighted, above New Map, New Web Page, Expand All and Collapse All.](/api/media/file/07b57af44ca64dc9860e7ccec9caf5c336eb549e-623x487.png)

- In the context menu that appears, click on "Setup"
- This will open the Site's configuration page

![](/api/media/file/8e09d3839c360a599cfd8b72f55460585e77e768-1803x698.png)

- Navigate to **Users and Groups**

![The Users and Groups window with the Groups tab and the Add Group button highlighted, above an empty group list.](/api/media/file/0d84a406e8970469875ccedb9f6e4174049cbd49-671x504.png)

**Expected result:** User and groups configuration accessed.

### Step 8 — Create User Group

UI path: Groups → Add

Navigate to **Groups** and then click **Add Group**. When prompted, set **Copy permissions from group** to **Restricted Users**.

![](/api/media/file/f7fdd452d3fd6721f034d93d1bb740556992524b-635x415.png)

![](/api/media/file/8d73313edc341223be9f1a986fd771086d262643-806x684.png)

**Expected result:** New user group created.

### Step 9 — Configure Group Settings

In the Edit Group dialog, configure the following details:

**Name:** Use **NXGEN** or **NXG** in the Name field (recommended).

Group Privileges — View Live Images:

- Use PTZ controls
- Lock PTZ controls
- Trigger Digital Outputs
- Broadcast to speakers
- Receive live events with identifying features
- View high-resolution images

Group Privileges — View Recorded Images:

- Export images
- View images recorded before login
- Licensed search for identifying features

Group Privileges — View Maps:

- Manage Maps
- Manage user sessions
- Listen to microphones

**Expected result:** Group privileges configured.

### Step 10 — Add Cameras to Group

In the **Access Rights** section of the Edit Group dialog, check all cameras you want to appear on the GCXONE platform. Click **OK** to save the changes.

![The Edit Group dialog with the Group Privileges list highlighted — export images, view images recorded before login, archive and more — beside the cameras the group may reach.](/api/media/file/291b0abfb555977d0deac159b4c3bcab8751083c-811x695.png)

![](/api/media/file/e7a914e4e44384d18bb228e7f3835e3e465f3fba-807x696.png)

![The Setup tab's General section with the Alarms tile highlighted, beside General, Users and Groups, Security, External Notifications and Rules.](/api/media/file/283d027eb8c1e55893b95f51f64cb7e50ae94a81-1903x718.png)

**Expected result:** Cameras assigned to user group.

### Step 11 — Configure Alarms

UI path: Setup → Alarms

Return to the Setup page from the previous step and navigate to **Alarms**. Click **Add** to create a new alarm.

![An empty alarms list with the Add button highlighted beside it.](/api/media/file/351f2aaad4db17eef0c8ae96fb5f6323429a1f1e-673x555.png)

![](/api/media/file/5444af4d3ea9d5592fa9db2ca224dc03874f56cb-691x569.png)

**Expected result:** Alarm configuration page accessed.

### Step 12 — Set Alarm Trigger Source

Set the alarm trigger source from the dropdown. Available options include:

- Motion Detection
- Video Analytics Event
- Digital Input Activation
- License Plate Watch List Match
- POS Transaction Exception
- Device Error
- System Error
- External Software Event
- Face Watch List Match

Select the cameras you are interested in, then click **Next**.

![](/api/media/file/b02a43db8e1d7e681482373503d56fbf255a6ec6-691x610.png)

**Expected result:** Alarm trigger source configured.

### Step 13 — Configure Alarm Recording Settings

- Select the devices you want to associate the alarm with
- Set the **Pre-Alarm Record Time** (recommended 10 seconds)
- Set the Recording Duration
- Click **Next**

![](/api/media/file/44e24551cd048fb99d8bc31fc3cb3bed4b92bcc6-710x599.png)

**Expected result:** Alarm recording settings configured.

### Step 14 — Configure Alarm Recipients

UI path: Alarm Recipients → Add Recipients

- Select alarm recipients
- Click on **Add Recipients** and ensure to select the user group you configured earlier (NXGEN/NXG)

![](/api/media/file/decd06c91dce5e64db4e0265fbc1a37a1f9a9bbe-677x526.png)

- Click **Next**

**Expected result:** Alarm recipients configured.

### Step 15 — Finalize Alarm Configuration

- Select the NXGEN user/group as configured
- Click **Add**
- Select the duration needed to notify the recipient when an alarm is triggered

![](/api/media/file/eec1b533beab9bc23e512f3b1ae4c90dee680375-732x646.png)

- Don't forget to **Save** the changes

**Expected result:** Alarm configuration completed and saved.

## Avigilon Config Guide with GCXONE

**Step 1:** Navigate to the **Devices** tab.

![Axxon](/api/media/file/0b3685017967d9a824624a8ba8c73e46733a7e96-1918x991.png)

**Step 2:** Click the **Add New** button.

![Axxon](/api/media/file/53753b3ef7d5edf917bad4c450952ebb5362ead0-1920x996.png)

**Step 3:** The **Add Device** dialog will be displayed.

![Axxon](/api/media/file/490bd5f86b138dc97fd443f9921dbb719899ae2c-1920x997.png)

**Step 4:** In the dialog, open the **Device** dropdown and select **Avigilon**.

![1](/api/media/file/Screenshot-2026-09-14-101805-edited-be91195b.png?prefix=media)

**Step 5:** Enter all required fields: Name, IP Address or Host Name, Serial Number, User Name, Password, Server Port, HTTPs Port.

![1](/api/media/file/Screenshot-2026-09-14-101844-edited-bb7ff414.png?prefix=media)

**Step 6:** Below the connection fields, the dialog also has a **Select Entity Group** dropdown, an **Enable Audio** toggle (on by default), a required **Timezone**, a **Device Configuration** section (Site Pulse Configuration), an **Advanced Settings** section (Event Polling, Configure Heatmap Mask, Periodic Health Check, Event Retention Time — 30 days by default), and an optional **Location** section (Latitude, Longitude, Plus Code, What3Words).

Note: Audio is disabled by default in ACC. To enable it: (1) open ACC settings and activate the speaker, and (2) assign the camera to that speaker. Both steps are required — enabling the audio toggle in GCXONE alone will not activate audio.

**Step 7:** Click **Discover**. You should see the sensors discovered.

![11](/api/media/file/Screenshot-2026-09-14-101917-edited-e991164e.png?prefix=media)

**Step 8:** Once the device is successfully discovered, click **Save**.

**Expected result:** Sensors discovered successfully in GCXONE.

Verification Checks:

- Verify WebAPI endpoint is functional
- Test user group access and permissions
- Confirm analytics are generating appropriate events
- Test alarm notifications
- Verify camera access through configured user group

**Expected result:** Complete Avigilon integration with GCXONE platform.

## Troubleshooting

WebAPI endpoint issues

- Verify WebAPI Endpoint is properly installed
- Check port forwarding configuration
- Ensure ACC server is accessible externally

User access problems

- Verify user group permissions are correctly configured
- Check camera assignments to user group
- Ensure proper privileges are granted

Analytics not working

- Check sensitivity settings (recommended 8–10)
- Verify area of interest is properly defined
- Confirm threshold time and timeout settings

Alarm configuration issues

- Verify alarm trigger sources are correctly selected
- Check recipient configuration matches user group
- Ensure recording settings are properly configured

### Notes

- WebAPI Endpoint installation is mandatory for external communication
- User group setup is required for GCXONE access
- Analytics configuration at camera level needed for event detection
- Recommended settings: Sensitivity 8–10, Threshold Time 2 seconds, Timeout 10 seconds
- Pre-alarm and post-motion recording recommended at 10 seconds
- Proper port forwarding setup required by IT team