Real-time gun detection with Frigate NVR on NVIDIA Jetson. Detections trigger recordings and snapshots, and alerts can go to other systems over MQTT.
Get the RTSP stream URL of your IP camera. Skip this if you only use the demo videos.
http://<camera-ip>) and confirm RTSP is enabledCommon RTSP URL formats:
- Hikvision:
rtsp://admin:password@<ip>:554/Streaming/Channels/101(main stream) or/102(sub stream)- Dahua:
rtsp://admin:password@<ip>:554/cam/realmonitor?channel=1&subtype=0(main) or&subtype=1(sub)- Generic ONVIF: Use the camera's ONVIF discovery tool to find the stream URL
Use the sub stream for detection and the main stream for recording.
| Symptom | Fix |
|---|---|
| Cannot access camera web interface | Test with ping <camera-ip>; make sure camera and computer are on the same subnet |
| RTSP stream not working | Confirm RTSP is enabled, check username/password, test in VLC first |
| Camera not found on network | Power cycle the camera, check the Ethernet cable, use the manufacturer's discovery tool (e.g., Hikvision SADP, Dahua ConfigTool) |
Deploy Frigate NVR and the gun detection model to the NVIDIA Jetson.
Deploy to a Jetson on the network over SSH.
| Symptom | Fix |
|---|---|
| NVIDIA runtime not found | sudo apt install nvidia-container-toolkit && sudo systemctl restart docker |
| Port 5000 already in use | docker stop $(docker ps -q --filter publish=5000) |
| Slow first startup | Model compilation takes 5-10 minutes the first time only |
| Container keeps restarting | Run docker logs frigate; usually a GPU memory or driver issue |
| RTSP camera not showing | Verify the URL in VLC, then edit config/config.yml as in step 3 and restart |
Open http://<device-ip>:5000. The two demo videos show gun detection boxes; RTSP cameras you entered appear as well.
Click below to open the Frigate dashboard.
| Symptom | Fix |
|---|---|
| Page not loading | Make sure the previous step deployed successfully |
| Wrong host/port | If you deployed to a remote device, use its IP in the URL |
SSH into the device and edit the configuration:
cd ~/gun-detection-frigate
nano config/config.yml
Add camera entries under cameras::
my_camera:
enabled: true
ffmpeg:
inputs:
- path: rtsp://admin:password@192.168.1.100:554/Streaming/Channels/101
roles:
- detect
- record
detect:
width: 1920
height: 1080
fps: 5
objects:
track:
- gun
Save and restart Frigate:
docker compose restart
config/config.yml (objects.filters.gun.threshold)record.retain.days)Real-time gun detection with Frigate NVR and a Hailo accelerator on reComputer AI Industrial R21. Detections trigger recordings and snapshots, and alerts can go to other systems over MQTT.
Get the RTSP stream URL of your IP camera. Skip this if you only use the demo videos.
http://<camera-ip>) and confirm RTSP is enabledCommon RTSP URL formats:
- Hikvision:
rtsp://admin:password@<ip>:554/Streaming/Channels/101(main stream) or/102(sub stream)- Dahua:
rtsp://admin:password@<ip>:554/cam/realmonitor?channel=1&subtype=0(main) or&subtype=1(sub)- Generic ONVIF: Use the camera's ONVIF discovery tool to find the stream URL
Use the sub stream for detection and the main stream for recording.
| Symptom | Fix |
|---|---|
| Cannot access camera web interface | Test with ping <camera-ip>; make sure camera and computer are on the same subnet |
| RTSP stream not working | Confirm RTSP is enabled, check username/password, test in VLC first |
| Camera not found on network | Power cycle the camera, check the Ethernet cable, use the manufacturer's discovery tool (e.g., Hikvision SADP, Dahua ConfigTool) |
Deploy Frigate NVR and the gun detection model to the reComputer AI Industrial R21.
Deploy to an R21 on the network over SSH. The deployment checks for and installs the HailoRT 4.21.0 driver if needed (5-10 minutes on first run).
ls /dev/hailo* on the device and confirm /dev/hailo0 is listed| Symptom | Fix |
|---|---|
| Hailo device not found | Check Hailo is seated in the M.2 slot; ls /dev/hailo* should show /dev/hailo0 |
| HailoRT version mismatch | HailoRT 4.21.0 is required; check with dpkg -l hailort. Install: curl -sfL https://raw.githubusercontent.com/blakeblackshear/frigate/dev/docker/hailo8l/user_installation.sh | sudo bash, then reboot |
| Insufficient disk space | At least 4 GB is needed; run docker system prune -a and sudo apt clean |
| Port 5000 already in use | docker stop $(docker ps -q --filter publish=5000) |
| Container keeps restarting | Run docker logs frigate-hailo; usually a Hailo driver issue |
| RTSP camera not showing | Verify the URL in VLC, then edit config/config.yml as in step 3 and restart |
Open http://<device-ip>:5000. The two demo videos show gun detection boxes; RTSP cameras you entered appear as well.
Click below to open the Frigate dashboard.
| Symptom | Fix |
|---|---|
| Page not loading | Make sure the previous step deployed successfully |
| Wrong host/port | If you deployed to a remote device, use its IP in the URL |
SSH into the device and edit the configuration:
cd ~/gun-detection-r2000-hailo
nano config/config.yml
Add camera entries under cameras::
my_camera:
enabled: true
ffmpeg:
inputs:
- path: rtsp://admin:password@192.168.1.100:554/Streaming/Channels/101
roles:
- detect
- record
detect:
width: 1920
height: 1080
fps: 5
objects:
track:
- gun
Save and restart Frigate:
docker compose restart
config/config.yml (objects.filters.gun.threshold)record.retain.days)