Integrations

Your home, earthquake-aware.

When the GeoShake network confirms an earthquake, your smart home can react in seconds — flash the lights, sound a siren, announce a warning, run your emergency scene. Free, open source, five-minute setup.

A helpful extra layer — not a life-safety system. Automations can be delayed or fail to run. For official earthquake early warning, always rely on your national authority (e.g. AFAD/Kandilli in Türkiye, USGS ShakeAlert in the US) and GeoShake's own app alerts.

Home Assistant

Available

Bring GeoShake earthquake alerts into Home Assistant in about five minutes. No coding, no configuration files — you just sign in with your GeoShake account.

What you'll need

No device required. You don't need a GeoShake sensor of your own to receive network-wide alerts — the integration listens to confirmed events from the whole GeoShake network. A GeoShake T1 of your own strengthens coverage where you live.

How it works

01

Network confirms

3+ GeoShake stations agree an earthquake is real — false alarms stay out.

02

Secure alert

The event reaches your Home Assistant over a personal, read-only, encrypted (TLS) connection.

03

Sensor turns ON

The Earthquake sensor flips ON for two minutes, then clears itself automatically.

04

Your home reacts

Automations run — lights, sirens, announcements, scenes, phone notifications.

The integration sets up its own connection — it does not use or occupy Home Assistant's MQTT integration.

Setup

Install the integration (HACS)

  1. In Home Assistant, open HACS.
  2. Click ⋮ (top right) → Custom repositories and add the repository below with type Integration:
https://github.com/GeoShake/geoshake-homeassistant
  1. Search for GeoShake in HACS → Download (latest version).
  2. Restart Home Assistant (Settings → System → Restart).

Sign in with your GeoShake account

  1. Go to Settings → Devices & Services → + Add Integration and search GeoShake.
  2. Choose "Sign in with GeoShake account (recommended)".
  3. Enter your GeoShake email and passwordSubmit.

That's it — your personal connection credentials are created automatically behind the scenes, and your account password is never stored in Home Assistant. A GeoShake Network device appears with three entities:

EntityWhat it shows
EarthquakeON when the network confirms an earthquake; clears after 2 minutes. Attributes: intensity class, station count, max PGA, coordinates, distance_km from your home.
Last eventTime of the most recent confirmed event, with the same attributes.
ConnectionLive connection status (diagnostic) — handy for support.

Quick check: Developer Tools → States, filter by geoshake. Earthquake should show off and Connection should be Connected.

Create an automation

Make Home Assistant do something when an earthquake is detected. Use the visual editor — it's the easiest way and avoids YAML mistakes.

  1. Settings → Automations & Scenes → + Create Automation → Start with an empty automation.
  2. When (trigger): Add Trigger → Entity → State · Entity: the GeoShake Earthquake sensor · To: On (Detected).
  3. Then do (action): pick what should happen — e.g. light.turn_on for a light or switch.turn_on for a smart plug.
  4. Save and name it, e.g. "GeoShake earthquake alert".
GoalAction to add
Flash lights redlight.turn_on → color red, brightness 100%
Power a siren or buzzerswitch.turn_on on the smart plug it's connected to
Voice announcementtts.speak"Earthquake warning. Take cover."
Run a scenescene.turn_on → your "emergency" scene
Phone notificationnotify.mobile_app_… → your device
Match the service to the device type. A smart plug is a switch → use switch.turn_on. Using light.turn_on on a plug won't work. And for voice: some smart speakers have limited non-English support — an English announcement or a language-independent siren sound is the most reliable.

Options — alert radius & auto-clear

Settings → Devices & Services → GeoShake → Configure:

OptionDefaultWhat it does
Alarm auto-clear delay120 sHow long the alarm stays ON after the last event.
Alert radius from home0 (off)0 = alarm for every confirmed network event. Set a distance in km to only trigger for earthquakes near your home. Uses your Home Assistant home location (Settings → System → General) — set it correctly first. The Last event sensor always shows every network event regardless of the radius.
One account = one installation. Signing in again on a second Home Assistant refreshes your personal credentials — the previous installation loses its connection. Advanced: a Manual MQTT credentials option also exists in the setup menu for users with dedicated read-only credentials; most users should use account sign-in.

Apple Home

Via Home Assistant

Home Assistant can expose the GeoShake sensor to Apple Home through its built-in HomeKit Bridge — so a confirmed earthquake can trigger HomePod automations, scenes and stronger notifications on your iPhone.

Add the HomeKit Bridge

Settings → Devices & Services → + Add Integration → HomeKit Bridge. When asked which entities to include, add the GeoShake Earthquake sensor.

Scan the code in the Home app

Home Assistant shows a setup / QR code. On your iPhone, open the Home app → Add Accessory → scan it.

Automate

The sensor appears in Apple Home as a safety sensor, so it can trigger HomePod automations — lights, scenes, alarm sounds — and time-sensitive notifications.

You'll need: Home Assistant always running, plus an Apple hub at home (HomePod or Apple TV) for automations to run.

Google Home

Available

Two ways to connect — pick whichever fits your setup.

Easiest: link your account directly

GeoShake has a direct Google Home integration that doesn't need Home Assistant at all. In the Google Home app, link your GeoShake account, then create a routine on the GeoShake Seismic Sensor — for example: "When Earthquake is detected → Broadcast 'Earthquake warning' on your speakers."

Via Home Assistant Cloud

  1. Settings → Home Assistant Cloud → enable Google Assistant (Nabu Casa).
  2. Expose the GeoShake Earthquake sensor.
  3. In the Google Home app, create your routine on the exposed sensor.

Understanding the alerts

Your data & privacy

Migrating from the old manual MQTT setup?
  1. Remove the mqtt: binary_sensor: GeoShake block from configuration.yaml (Developer Tools → Check Configuration → reload YAML).
  2. If the GeoShake server occupied your MQTT integration, delete that MQTT config or repoint it to your own local broker — the new integration connects on its own and frees the MQTT slot.
  3. Install the integration (steps above) and update your automations to trigger on the new Earthquake entity.

Troubleshooting

"Invalid email or password"

Check your GeoShake account credentials — the same ones you use for the GeoShake app and Google Home linking.

"Too many attempts"

Wait about 5 minutes and try again — sign-in is rate-limited for security.

"Could not connect to the GeoShake server"

Check your internet connection and that outbound port 8883 isn't blocked by your firewall, then try again.

Entities show "Unavailable"

Check the Connection diagnostic entity. The integration reconnects automatically; if it stays disconnected, your network may block port 8883 — or your credentials were refreshed by a newer installation. Re-add the integration to sign in again.

The sensor exists but never turns ON

Normal until an earthquake occurs. The Last event sensor shows the most recent confirmed network event.

The alarm never triggers with a radius set

Make sure your Home Assistant home location is set (Settings → System → General) — the radius measures from there. Set the radius to 0 to receive all events.

The automation runs but nothing happens

Check that the service matches the device: smart plug → switch.turn_on, light → light.turn_on.

GeoShake doesn't appear in HACS search

Make sure you added the custom repository with type Integration, then refresh HACS.

Make your home part of the network.

The GeoShake T1 strengthens detection where you live — and your smart home reacts the moment it matters.