Use this for a device in a LAN or behind a VPN that GC Surge cannot reach from the internet. A small program, the local agent, runs once on a computer or phone in the same network as the device. It writes the alarm settings to the device. After that the device sends its alarms to GC Surge itself. The agent is needed for setup only, not for the alarms.
Who it is for: Admins who set up sites and devices, and the technician or site contact who helps on site.
Watch (admin):
Watch (on site):
Choice | What happens |
|---|---|
I am on-site | You install the local agent yourself on a device in the camera network. The steps are shown right after you add the device. |
Delegate installation | Enter Contact person, Contact email and, if you want, Contact phone. This person receives the site key and the steps to install the local agent. |
The person on site needs no GC Surge account. Use a Windows or macOS computer that is connected to the same network as the cameras and has internet access.
/site-setup. The instructions you received contain the link.GCSK-1234-5678, and click Continue.What you see in the table Devices | Meaning |
|---|---|
Port: open | The computer reaches the device. |
Port: closed or check_failed | The computer does not reach the device. It is in another network, or the address or port is wrong. |
Inject: success or configured | The alarm settings are on the device. |
Inject: failed | The device refused. The column Note says why, for example wrong credentials. |
Inject: skipped | The device was not handled, for example because an address is missing. The admin corrects it with Edit. |
If you closed the setup window, open the device Actions > Complete setup to see the steps again.
You are on site yourself? Choose I am on-site. Open GC Surge on a computer in the camera network. After Add device the next screen shows the same download buttons and Retry connection. When the agent is found, GC Surge writes the settings ("Applying SMTP settings via local agent…") and the device becomes Configured. You do not need the on-site setup page.
Symptom | Cause | What to do |
|---|---|---|
Local Agent Not Connected | The agent is not installed, not running, or not on this computer. | Download and start the agent, then click Retry connection. |
"Local agent update required" or "Your local agent is out of date." | The installed agent is too old. | Download the latest agent, install it, then click Check version again. |
"Invalid or expired site key" or "Site session has expired" | The activation has ended, or the key was typed wrong. | The admin clicks Reactivate site key or Activate site key. Enter the key again. Check the letters and digits. |
The installer buttons do not appear ("Could not load installer links. Please try again.") | The links could not be loaded. | Reload the page. If they are still missing, ask the admin to download the installer in GC Surge (device … menu > Complete setup) and send it to you. |
Retry Connection does nothing, the page still shows Local Agent Not Connected | The agent is not started, or it is installed on another computer than the one with the browser. | Start the agent on this computer. Browser and agent must be on the same computer. |
"Site key activation expired" | More than 30 minutes passed. | Click Reactivate site key. |
The page shows "No private devices found for this site." | The devices were not added to this site in GC Surge, or the key of another site was used. | The admin checks that the devices are listed under this site. Use the key of this site. |
A device is shown as failed in the agent summary | Wrong address, port or credentials, or the computer is in another network than the camera. | Check that the computer can open the device web page. The admin corrects the details with Edit. Then run the setup again. |
"Paused — agent disconnected" | The agent was closed or the computer went to sleep during setup. | Start the agent again and continue. Keep the computer awake. |
"Your device was added, but automatic SMTP setup did not complete." | The device refused the settings. | Enter the settings by hand. See "Manual settings" below. |
The admin sees Setup needed for a long time ("Site is Pending — waiting for on-site setup") | The on-site step is not done yet. | Ask the contact. Use Resend instructions if they did not get the message. |
"Device was added, but we could not email setup instructions to …" | The contact e-mail is wrong or could not be reached. | Send the site key with Send site key by WhatsApp or to another address. |
Status is Configured but no alarm arrives | The camera cannot send to the internet, or detection is not active. | Check outbound internet access and DNS on the camera. Check that detection is switched on. Trigger a test event. |
"Local agent is offline. Start the agent before retrying." when you use Retry | Retry and Edit for a private device need the agent in the site network. | Start the agent on site, then use Retry from a browser on that computer. |
Manual settings
If the automatic setup of a device fails, you can enter the alarm e-mail settings on the device yourself.
Does the local agent have to stay installed? No. It is needed for setup, and again when you use Retry or Edit for a private device.
Thank you — your feedback goes to the team that owns this page.