[ All integrations ](https://ohdear.app/third-party-integrations)

# Home Assistant Integration

Display Oh Dear uptime monitoring in your Home Assistant smart home dashboard.

[ owenvoke/hass-ohdear ](https://github.com/owenvoke/hass-ohdear)

by [ Owen Voke ](https://voke.dev)

## Oh Dear for Home Assistant [\#](#oh-dear-for-home-assistant)

Bring your website monitoring into your smart home dashboard. This Home Assistant integration, created by Owen Voke, displays Oh Dear uptime data as sensors you can use in automations and dashboards.

For a detailed walkthrough, see [Owen's blog post about the integration](https://voke.dev/blog/home-assistant-ohdear/).

## Features [\#](#features)

- **Uptime Sensors**: Create sensors for each monitored site showing uptime status
- **Dashboard Cards**: Display site status using Lovelace cards
- **Automations**: Trigger Home Assistant automations when sites go down
- **History Tracking**: View uptime history in Home Assistant's history panel

## Installation via HACS (Recommended) [\#](#installation-via-hacs-recommended)

1. Add the custom repository: `https://github.com/owenvoke/hass-ohdear`
2. Search for "Oh Dear" and install the integration
3. Add the integration via the Home Assistant UI
4. Enter your Site ID and API token from the [Oh Dear API Tokens page](https://ohdear.app/user/api-tokens)

## Manual Installation [\#](#manual-installation)

1. Download the ZIP from the [GitHub repository](https://github.com/owenvoke/hass-ohdear/archive/main.zip)
2. Extract `custom_components/ohdear` to your Home Assistant installation
3. Add the integration via the UI with your Site ID and API token

## Uptime Card Integration [\#](#uptime-card-integration)

This integration pairs nicely with the custom [Uptime Card](https://github.com/dylandoamaral/uptime-card). Use `succeeded` instead of `ok` for the status:

```
<span class="hl-keyword">type</span><span class="hl-property">:</span> <span class="hl-keyword">custom</span>:uptime-card
<span class="hl-keyword">entity</span><span class="hl-property">:</span> sensor.example_org_uptime
<span class="hl-keyword">status_adaptive_color</span><span class="hl-property">:</span> true
<span class="hl-keyword">ok</span><span class="hl-property">:</span> succeeded
```

## Debug Logging [\#](#debug-logging)

If you encounter issues, enable debug logging via YAML:

```
<span class="hl-keyword">logger</span><span class="hl-property">:</span>
  <span class="hl-keyword">default</span><span class="hl-property">:</span> warning
  <span class="hl-keyword">logs</span><span class="hl-property">:</span>
    custom_components.<span class="hl-keyword">ohdear</span>: debug
    <span class="hl-keyword">ohdear</span><span class="hl-property">:</span> debug
```

Report issues on the [GitHub repository](https://github.com/owenvoke/hass-ohdear/issues).

## Screenshots