Aegis for Ajax for Home Assistant (Marketplace integration)

Installs: 817 sharing analytics
GitHub stars: 136
Connection: Uses the vendor's cloud
Upkeep: Updated in the last 6 months
Version: v1.28.0, October 25, 2026
Category: Security and safety, Alarm systems
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: aegis_ajax
Source: github.com/bvis/aegis-hass
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

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

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.

Provides

Lights
Valves
Cameras
Locks
Alarms
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Aegis for Ajax — Login

EmailThe email you use to sign in to the Ajax app.
PasswordYour 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 CodeThe 6-digit code from your authenticator app.

Also asked when signing in again and changing the connection.

Select Spaces

SpacesThe spaces (hubs) to add to Home Assistant. Pick at least one.

Re-authenticate Aegis for Ajax

PasswordYour 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" buttonAdds 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 statesWhen 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 notificationsEnable 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.

Entities

Binary sensorsCRA 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
ButtonsCapture photo, Refresh hub, Restore after alarm, Test sound
CamerasLive view
EventsSecurity event, Doorbell, Button
NumbersAlarm duration
SelectsSiren volume
SensorsCRA 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
SwitchesChannel 1, Channel 2, Bypass, Arm in night mode, Chime
UpdatesFirmware

Actions

Force armArm the system ignoring open sensors and active alarms.Fields: Entity, Alarm PIN
Force arm night modeArm night mode ignoring open sensors and active alarms.Fields: Entity, Alarm PIN
Disarm night modeExit 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 modeEnable 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 imagesImport 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 sessionsReturn 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 sessionImmediately 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 sessionsImmediately 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

DiagnosticsDownloads a diagnostics file to attach to a bug report.
System healthAdds its status to Home Assistant's system information.
Repair noticesNotices 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, MIT License. Shortened.