--- title: "Aegis for Ajax" description: "Aegis for Ajax is a Marketplace integration for Home Assistant. It has 817 installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026." canonical: "https://vulpo.app/integrations/marketplace/bvis-aegis-hass" url: "https://vulpo.app/integrations/marketplace/bvis-aegis-hass.md" last-updated: "2026-10-26" version: "1.4" --- # Aegis for Ajax > Aegis for Ajax is a Marketplace integration for Home Assistant. It has 817 installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026. Aegis for Ajax is an unofficial integration that connects Ajax Security Systems to Home Assistant through the Ajax cloud. It works with the main Ajax app and with co-branded apps, using the same app protocol and regular account credentials rather than an enterprise API key. It adds alarm panels with night mode, group arming and optional PIN protection, plus binary sensors, sensors, switches, buttons, events, firmware updates and a cloud live view for video cameras. Hub network details such as Wi-Fi, Ethernet and cellular status are exposed as sensors. Actions cover force arm, disarm of night mode only, a panic button, Photo on Demand settings and management of account sessions. Push notifications through FCM credentials deliver real-time events, and repair notices flag problems with them. Setup is done in the UI, with support for two-factor codes. Automatic summary of the README and code of bvis/aegis-hass. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=bvis&repository=aegis-hass&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=bvis&repository=aegis-hass&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **Found by itself**: Home Assistant spots it on the network and offers to add it. - **Device triggers**: Its devices can start automations directly. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Aegis for Ajax — Login - **Email**: The email you use to sign in to the Ajax app. - **Password**: Your Ajax account password. Home Assistant keeps only a hash of it. - **App label (co-branded app name)**: The app your account belongs to: Ajax or a co-branded app. See the README if you're not sure. Also asked when changing the connection. ### Two-Factor Authentication - **TOTP Code**: The 6-digit code from your authenticator app. Also asked when signing in again and changing the connection. ### Select Spaces - **Spaces**: The spaces (hubs) to add to Home Assistant. Pick at least one. ### Re-authenticate Aegis for Ajax - **Password**: Your Ajax account password. Home Assistant keeps only a hash of it. ### After setup - **Fallback poll interval (seconds, 60-300)** - **Force arm (ignore open sensors and malfunctions)** - **Show "Arm Home" button**: Adds an Arm Home option to the alarm panel. It mirrors Night mode and is mainly needed for Amazon Alexa or Nabu Casa Cloud. Turn it off to hide the duplicate button if you don't use them. - **Show exit / entry delays as panel states**: When on, the alarm panel shows "arming" while the hub runs a detector's "Delay when leaving" and "pending" while a "Delay when entering" runs — both driven by the hub's own signals, not a timer of ours. Detectors without a delay (Instant Alarm) are already live during "arming". Automations waiting for "armed\_away" will fire once the exit delay completes. The hub's raw state stays in the "hub\_state" attribute. - **Cloud live view for video cameras (experimental)**: Adds a live-view camera for each Ajax video camera, streamed through the Ajax cloud the way the app does away from home, so it also works when Home Assistant is not on the camera's network. Experimental: it may not work on every camera yet. Each view opens one video session; nothing runs while nobody is watching. - **Require PIN code for arm/disarm** - **PIN code** - **FCM Project ID (for push notifications)** - **FCM App ID** - **FCM API Key** - **FCM Sender ID** - **Delete FCM credentials (clears all four fields)** - **I don't use push notifications**: Enable this if you intentionally run without push. It hides the recurring "FCM not configured" reminder and Repair card. Real-time events (doorbell, arm/disarm, alarm, motion) still won't reach Home Assistant until you configure FCM. - **Photo retention (days)** - **Max photos per device (0 = unlimited)** Texts from the code of [bvis/aegis-hass](https://github.com/bvis/aegis-hass). ## Entities - **Binary sensors**: CRA connection, Cellular connected, Lid opened, External contact broken, External contact alert, Case drilling, Anti-masking, Malfunction, Interference, Relay stuck, Always active, Glass break, and 15 more - **Buttons**: Capture photo, Refresh hub, Restore after alarm, Test sound - **Cameras**: Live view - **Events**: Security event, Doorbell, Button - **Numbers**: Alarm duration - **Selects**: Siren volume - **Sensors**: CRA company, Signal strength, Mobile network type, Wi-Fi signal level, SIM status, IMEI, Connection type, Wi-Fi SSID, Wi-Fi IP address, Ethernet IP address, Ethernet gateway, Ethernet DNS, and 8 more - **Switches**: Channel 1, Channel 2, Bypass, Arm in night mode, Chime - **Updates**: Firmware ## Actions - **Force arm**: Arm the system ignoring open sensors and active alarms. Fields: Entity, Alarm PIN - **Force arm night mode**: Arm night mode ignoring open sensors and active alarms. Fields: Entity, Alarm PIN - **Disarm night mode**: Exit night mode while leaving any independently armed (away) groups armed. Unlike a full disarm, this only stands down the night-mode groups — the native Ajax "disarm night mode" operation. Fields: Entity - **Press panic button (SOS)**: Trigger the Ajax SOS / panic button on a space. Calls the same endpoint as the red SOS button in the official mobile app and forwards a Panic alarm to the monitoring station (CRA), which on most contracts triggers immediate police dispatch and bypasses verification windows. Use only for genuine emergencies. The confirm field must be set to true or the call is rejected. Fields: Confirm panic, Entity, Latitude, Longitude - **Set Photo on Demand mode**: Enable or disable Photo on Demand mode on a hub. Two independent channels can be toggled separately — user requests (whether hub users can request photos from the Ajax app) and scenarios (whether scenarios / automations can trigger captures). Leave a field unset to keep its current value. At least one is required. Fields: User requests, Scenarios, Entity - **Refresh alarm camera images**: Import recent alarm photos into local albums without taking a new photo. New alarm pushes import automatically. Manual backfill is limited to once per five minutes per space, with one history query and at most ten media streams; completed local albums are skipped. Fields: Entity - **List account sessions**: Return active Ajax account sessions for manual inspection on demand. This service calls an internal Ajax endpoint that may rate limit frequent requests; do not poll it in automations. The currently active Aegis session is marked is\_current when it can be identified. Fields: Config entry ID - **Terminate account session**: Immediately log the selected other device out of the Ajax account. Obtain its session ID through list\_client\_sessions. The integration never terminates its own session. Fields: Session ID, Confirm termination, Config entry ID - **Terminate all other account sessions**: Immediately log all other devices out of the Ajax account. This signs out other active Ajax mobile and desktop apps. The integration never terminates its own session. Fields: Confirm termination, Config entry ID ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **System health**: Adds its status to Home Assistant's system information. - **Repair notices**: Notices it can show in Settings, Repairs: Hub network sensors degraded, Push notifications disabled — FCM credentials rejected, Push notifications not configured — real-time events disabled, Push notifications interrupted — the same message keeps ending the connection, Ajax is rejecting this version of Aegis for Ajax, Push notifications are not arriving, Set the alarm PIN again ## From the README > Disclaimer: This is an unofficial third-party integration and is not affiliated with, endorsed by, or supported by Ajax Systems. Use at your own risk. This integration communicates with Ajax Systems servers using the same protocol as the official mobile app. Ajax Systems may change their API at any time, which could break this integration without notice. > > Aegis is a Home Assistant custom integration for Ajax Security Systems — works with any co-branded Ajax app (Protegim, ADT, G4S, and many more). > > - Alarm Control Panel: Arm away, disarm, night mode, group arming with PIN code support. When the space is in group / zone mode, per-group panels are created and react to FCM push events instantly —… > - Force Arm Services: aegis\_ajax.force\_arm and aegis\_ajax.force\_arm\_night to arm ignoring open sensors > - Binary Sensors: Door open/close, motion detection, smoke, steam (FireProtect 2 chamber discriminator), leak, tamper, CO, heat, glass break, vibration, tilt (DoorProtect Plus accelerometer), CRA… > - Hub Network: Real-time hub network data — ethernet/wifi/gsm connection status, Wi-Fi SSID and signal strength, IP addressing, cellular signal strength and network type, power supply status > - Sensors: Battery level, temperature, humidity, CO2, signal strength, GSM type (2G/3G/4G), Wi-Fi signal level, Wi-Fi SSID, Wi-Fi IP, IMEI, Ethernet IP/gateway/DNS, cellular signal/network, connection… From the README of [bvis/aegis-hass](https://github.com/bvis/aegis-hass#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Security and safety](https://vulpo.app/integrations/category/security-and-safety.md), Alarm systems - Number: 817 installs sharing analytics; 136 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v1.28.0, last updated October 25, 2026 - Domain: `aegis_ajax` - Source: - Issues: In Vulpo: Light card, Quick Toggle card, Lock card, Alarm Panel card (Pro), Apple Watch, Control Center Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-26. Source: https://vulpo.app/integrations/marketplace/bvis-aegis-hass --- - HTML version of this page: https://vulpo.app/integrations/marketplace/bvis-aegis-hass - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml