Documentation/Setup Methods/Desktop Agent

Desktop Agent Setup

Install the Perimi Desktop Agent for automatic camera discovery and local processing

Supported Platforms

🪟

Windows

Windows 10, 11

Download Size25MB
4GB RAM
500MB disk space
.NET 6.0
Auto-discovery
Background service
System tray
Windows integration
🍎

macOS

macOS 11+

Download Size30MB
4GB RAM
500MB disk space
Intel/Apple Silicon
Auto-discovery
Menu bar app
Keychain integration
Notification Center
🐧

Linux

Ubuntu 20.04+, CentOS 8+

Download Size20MB
4GB RAM
500MB disk space
SystemD
Auto-discovery
Systemd service
Command line
Package manager

Installation Process

1

Download Agent

Download the appropriate agent for your operating system

Windows: perimi-agent-windows-x64.msi macOS: perimi-agent-macos-universal.dmg Linux: perimi-agent-linux-x64.deb/.rpm
2

Install & Launch

Run the installer and launch the Perimi Desktop Agent

Windows: Run MSI installer macOS: Mount DMG, drag to Applications Linux: sudo dpkg -i perimi-agent.deb
3

Connect Account

Sign in to your Perimi account to link the agent

Agent → Sign In → Enter credentials Generate device token if needed
4

Network Discovery

Let the agent discover cameras on your local network

Auto-discovery runs automatically Manually add cameras if needed Configure detection settings

Key Features

Automatic Camera Discovery

Scans your network for ONVIF, RTSP, and IP cameras

No manual configuration
Finds hidden cameras
Updates automatically
Supports 500+ models

Local Processing

Process video streams locally before cloud analysis

Reduced bandwidth
Lower latency
Privacy protection
Offline capability

Secure Communication

Encrypted connection to Perimi cloud services

TLS 1.3 encryption
Certificate pinning
Zero-trust architecture
Regular updates

Background Operation

Runs quietly in the background without interruption

System service
Auto-start
Resource efficient
Status monitoring

Troubleshooting Guide

Common issues and solutions

Agent won't start

Common Causes:

  • • Insufficient permissions
  • • Port conflicts
  • • Firewall blocking

Solutions:

  • • Run as administrator
  • • Check port 8080
  • • Allow in firewall

No cameras discovered

Common Causes:

  • • Network isolation
  • • ONVIF disabled
  • • Wrong subnet

Solutions:

  • • Check VLAN config
  • • Enable ONVIF on cameras
  • • Manual IP entry

High CPU usage

Common Causes:

  • • Too many streams
  • • High resolution
  • • Hardware limits

Solutions:

  • • Reduce stream count
  • • Lower resolution
  • • Upgrade hardware

Ready to Install the Desktop Agent?

Get started with automatic camera discovery and local processing

Download NowCamera GuideGet Support
Perim - AI-Powered Anomaly Detection for Critical Infrastructure