This step-by-step guide will help you set up the AegisGates Bridge on your local computer to connect your camera to our cloud platform. The bridge runs on your computer and securely streams video from your camera to AegisGates for AI analysis.

Prerequisites



Before you begin, make sure you have:
  • A computer running Windows, macOS, or Linux

  • Your camera connected to your local network

  • Administrator privileges on your computer

  • The IP, username and password of your camera (RTSP and ONVIF)


Step 1: Download the Setup File



The first step is to download the automated setup script for your camera. This script will configure everything you need to connect your camera to AegisGates.

Watch the video tutorial:



Instructions:
  • Log in to your AegisGates dashboard at https://www.aegisgates.com

  • Navigate to your camera in the Cameras section

  • Click the "Setup" button for your camera (for Windows or macOS/Linux)

  • The script (setup_xx.bat or setup_xx.sh where xx is your camera ID found your the camera list) will be saved to your selected folder


Note: The setup script contains your unique camera credentials and configuration. Keep it secure and do not share it.

Step 2: Run the Setup File



After downloading, you need to run the setup script to install the bridge software and configure your camera connection.

Watch the video tutorial:



For Windows:
  • Open your folder that the setup file is saved

  • Locate the downloaded .bat file (e.g., setup_81.bat)

  • Right-click on the file and select "Run as administrator"

  • A command window will open and automatically:

- Create an aegisgates folder in your Downloads
- Download Python dependencies
- Download the bridge script
- Save your camera configuration
  • Wait for the installation to complete (usually 1-2 minutes)

  • The window will stay open in the aegisgates folder when done


For macOS/Linux:
  • Open Terminal

  • Navigate to your folder that the setup file is saved: 

e.g. cd ~/Downloads

  • Make the script executable: 

e.g. chmod +x setup_xx.sh (where xx is your camera ID)

  • Run the script: 

./setup_xx.sh

  • The script will automatically install everything to an aegisgates folder

  • Wait for the installation to complete


Tip: If you see any security warnings, approve them - the script only installs necessary components for the bridge.

Step 3: Start the Bridge



Now that everything is installed, you can start the bridge to begin streaming your camera to AegisGates.

Watch the video tutorial:



For Windows:
  • In the command window (still open in the aegisgates folder), run: 

bridge_xx.bat (where xx is your camera ID)

  • Enter the IP, username and password if it is run for the first time

  • Once connected, you'll see: "✓ Bridge running - streaming to AegisGates"

  • Keep this window open - closing it will stop the bridge


For macOS/Linux:
  • Navigate to the aegisgates folder: 

e.g. cd ~/Downloads/aegisgates

  • Start the bridge: 

./bridge_xx.sh (where xx is your camera ID)

  • Enter the IP, username and password if it is run for the first time

  • Once connected, you'll see: "✓ Bridge running - streaming to AegisGates"

  • Keep this terminal open - the bridge must run continuously


Verifying Your Connection



After starting the bridge, verify everything is working:

  • Go to your AegisGates dashboard

  • Check your camera status - it should show "Streaming"

  • Within a few minutes, you should see AI narratives generated automatically for detected activities


Running the Bridge on Startup (Optional)



To have the bridge start automatically when your computer boots:

Windows:
  • Press Win + R, type shell:startup, press Enter

  • Create a shortcut to your bridge script (bridge.bat) in the startup folder

  • Right-click the shortcut → Properties → Run as administrator


macOS:
  • Open System Preferences → Users & Groups

  • Select your user → Login Items

  • Click + and add the bridge script (./bridge_xx.sh)


Linux:
  • Add the bridge command (./bridge_xx.sh) to your ~/.bashrc or create a systemd service

  • Example systemd service file available in our documentation


Troubleshooting



Bridge won't start:
  • Make sure Python is installed (3.8 or higher)

  • Check that all files are in the aegisgates folder

  • Verify your camera is accessible on the network


No clips appearing:
  • Confirm the bridge shows "connected" status

  • Check your camera's RTSP stream is working

  • Verify your camera credentials are correct


Connection drops:
  • Check your internet connection

  • Ensure your computer doesn't go to sleep

  • Verify firewall isn't blocking the bridge


Need help? Contact our support team at [email protected] or visit our Support Center for more articles.

What's Next?



Once your bridge is running:
  • Read AI Narratives: Get intelligent summaries of detected activities

  • Set Up Alerts: Configure notifications for important events

  • Add More Cameras: Repeat this process for additional cameras


Happy monitoring! 🎥✨