User Guide & Installation Manual
Table of Contents
System Requirements
Before installing GarudAI, ensure your Windows PC meets the following requirements:
| Requirement | Minimum | Recommended |
|---|---|---|
| OS | Windows 10 64-bit (v1809+) | Windows 11 64-bit |
| RAM | 8 GB | 16 GB |
| CPU | 4-core, 2.5 GHz | 8-core, 3.5 GHz |
| Disk Space | 50 GB free | 100 GB SSD |
| GPU | Not required | NVIDIA with 4GB+ VRAM |
| Internet | Required for setup & license | Broadband recommended |
| Display | 1280×720 | 1920×1080 |
What Gets Installed
| Component | Purpose | Installed By |
|---|---|---|
| WSL2 | Required for Docker on Windows | Installer |
| Docker Desktop | Runs GarudAI containers | Installer |
| GarudAI Services (11 containers) | AI surveillance engine | Installer |
| GarudAI Tray App | System tray control panel | Installer |
The 11 GarudAI Services
| Service | What It Does |
|---|---|
| Backend API | AI processing, REST API, WebSocket live feeds |
| Frontend | Web dashboard accessed via browser |
| PostgreSQL | Database for cameras, alerts, users |
| Redis | Real-time messaging, task queue |
| Celery Worker | Async tasks (alerts, backups, notifications) |
| Celery Beat | Scheduled tasks (auto-backup) |
| MediaMTX | RTSP/HLS/WebRTC video streaming |
| Prometheus | System metrics collection |
| Grafana | Monitoring dashboards |
| MinIO | Video clip and snapshot storage |
| Jaeger | Request tracing (advanced diagnostics) |
Installation Guide
Step 1 — Run the Installer
- Double-click GarudAI-Setup-v2.0.exe
- If Windows asks "Do you want to allow this app to make changes?" — click Yes
- The installer wizard will open
Step 2 — Accept the License Agreement
Read the End User License Agreement and click I accept the agreement, then Next.
Step 3 — Choose Installation Directory
Default: C:\Program Files\GarudAI — recommended. Click Next.
Step 4 — System Checks
The installer automatically verifies: Windows version, 64-bit OS, 8 GB RAM, 50 GB free disk. If any check fails, an error message will guide you.
Step 5 — WSL2 Installation
Step 6 — Docker Desktop Installation
If Docker Desktop is not installed, the installer downloads and installs it (~500 MB). This may take 5–10 minutes depending on internet speed.
Step 7 — Downloading AI Components
Step 8 — Installation Complete
When done, the GarudAI tray icon appears in your system tray. Open the dashboard at http://localhost:3010.
First Login
Password: Admin@12345
Trial Period & Limitations
GarudAI includes a 7-day free trial automatically on first install. No credit card required.
| Feature | Trial | Paid Plan |
|---|---|---|
| Cameras | 1 camera only | Up to 5 (+ add-ons) |
| Object Detection (80 classes) | ✅ | ✅ |
| Face Recognition | ✅ | ✅ |
| License Plate OCR | ✅ | ✅ |
| Weapon Detection | ❌ Not available | ✅ Full access |
| Alerts & Notifications | ✅ | ✅ |
| Grafana Monitoring | ✅ | ✅ |
Purchasing a License
Visit purchase.garudai.com to buy a license. Select your plan, fill in your details, and pay securely via PayU (UPI, cards, net banking).
Your product key and GST invoice are emailed instantly after payment.
Purchase Steps
- Go to purchase.garudai.com
- Select a plan (Quarterly / Half-Year / Annual)
- Add extra camera slots if needed
- Enter your name, email, and phone
- Click Proceed to Pay → complete PayU payment
- Check your email for the product key and invoice
Activating Your License Key
Via Tray App (Recommended)
- Click the GarudAI icon in the system tray (bottom-right taskbar)
- Select Activate License…
- Enter your product key:
GRDI-XXXX-XXXX-XXXX-XXXX - Click Activate — full access restored immediately
Via Dashboard
Go to http://localhost:3010 → Settings → License → enter key → Activate.
Adding Cameras
Supported Camera Types
| Type | Example URL |
|---|---|
| IP Camera (RTSP) | rtsp://192.168.1.100:554/stream1 |
| HTTP MJPEG | http://192.168.1.100:8080/video |
| USB Webcam | Index: 0, 1, etc. |
| ONVIF | Auto-discovered on local network |
Adding a Camera
- Go to Cameras → Add Camera
- Enter camera name, RTSP/HTTP URL or webcam index
- Select camera type and location label
- Click Add Camera
AI Detection Features
| Category | Examples | Severity |
|---|---|---|
| Humans | Person | Info |
| Firearms (Paid) | Gun, Rifle, Pistol | 🔴 Critical |
| Sharp Weapons (Paid) | Knife, Sword, Machete | 🔴 Critical |
| Vehicles | Car, Truck, Motorcycle | Info |
| Animals | Dog, Cat, Bear | Info |
Enabling Detection
Cameras → select camera → Detection Settings → toggle Enable AI Detection → choose categories → set confidence threshold (default 40%).
Face Recognition
Face Recognition → Add Profile → upload a clear frontal photo → enter name. GarudAI automatically matches this person in future detections.
License Plate Recognition
Detected plates are automatically read via OCR and stored. Search recorded plates under the License Plates section.
Alerts & Notifications
Email Alerts
Settings → Notifications → enter SMTP server, email address, minimum severity → Save & Test.
Telegram Alerts
- Create a Telegram bot via @BotFather → get token and chat ID
- Settings → Notifications → Telegram → enter token and chat ID → Save & Test
Troubleshooting
11.1 — Dashboard Won't Open (localhost:3010)
Check the tray icon colour. If red/yellow: tray → Restart Services → wait 60 seconds.
If still failing, open Command Prompt as Admin and run: cd "C:\Program Files\GarudAI" && docker compose ps
11.2 — Docker Desktop Not Starting
Open Task Manager → find Docker Desktop → End Task → reopen from Start Menu. Allow any update and wait 2–3 minutes.
11.3 — Virtualization Not Enabled
- Restart PC → press F2/F10/DEL/ESC to enter BIOS
- Find "Virtualization Technology", "Intel VT-x", or "AMD-V" → Enable
- Save and exit → restart Windows
11.4 — WSL2 Issues
Open PowerShell as Admin and run:
wsl --update then wsl --set-default-version 2, then restart Docker Desktop.
11.5 — License Activation Fails
Check internet connection. If behind a corporate proxy, whitelist licensestore.garudai.com. Contact support@garudai.com with your product key.
11.6 — Camera Feed Not Showing
Verify the RTSP URL works in VLC first. Ensure PC and camera are on the same network. Check that port 8554 is not blocked by firewall.
License Plans & Pricing
| Plan | Duration | Cameras | Weapon Detection | Price (incl. 18% GST) |
|---|---|---|---|---|
| Trial | 7 days | 1 | ❌ | Free |
| Quarterly | 3 months | 5 | ✅ | ₹11,800 |
| Half-Year | 6 months | 5 | ✅ | ₹21,240 |
| Annual | 12 months | 5 | ✅ | ₹37,760 |
| Extra Camera | Per month | +1 per slot | ✅ | ₹2,950/cam/month |
All paid plans include full weapon detection, face recognition, LPR, and all other features. GST-compliant invoice emailed automatically on purchase.
Frequently Asked Questions
Can I install on multiple PCs with one license?
No. Each key is tied to one machine's hardware fingerprint. Purchase separate licenses for each PC. Contact us for volume pricing.
What happens when my trial expires?
The system continues running with trial restrictions (1 camera, no weapon detection). No data is lost. Purchase at purchase.garudai.com to restore full access.
Do I need internet all the time?
No. Internet is needed for setup and license validation (once per 24 hours). If the license server is unreachable, GarudAI continues working for up to 48 hours using the last validated state.
Are my camera feeds stored in the cloud?
No. All video processing and storage happens locally on your PC. Only license validation data (machine fingerprint + product key) is sent to our servers.
What if I need more than 5 cameras?
Purchase Extra Camera add-ons at ₹2,950/camera/month. There is no hard upper limit.
How do I transfer my license to a new PC?
Email support@garudai.com with your product key. We reset the machine binding within 1 business day.
Can GarudAI work offline (air-gapped)?
Contact support@garudai.com for an offline license arrangement.
