Ring

The Ring integration allows you to integrate your Ring.com devices in Home Assistant. Due to recent authentication changes of Ring, you will need to run at least Home Assistant 0.104.

There is currently support for the following device types within Home Assistant:

• Binary sensor
• Button
• Camera
  • Saving the videos captured by your Ring Door Bell
• Event
• Sensor
• Siren
• Switch
• Light
• Number

Configuration

To add the Ring integration to your Home Assistant instance, use this My button:

Ring can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Binary sensor

The binary sensor switches off and on when motion, doorbell rings, and intercom unlock events occur.

The binary sensor is being replaced with the event entity, and you should migrate any automations to the event entity by release 2025.4.0.

Button

Once you have enabled the Ring integration, you can start using the button platform. Currently, it supports intercom to open the door.

Camera

Once you have enabled the Ring integration, you can start using the camera platform. Currently, it supports doorbell and stickup cameras.

Saving the videos captured by your Ring Door Bell

You can save locally the latest video captured by your Ring Door Bell using the downloader along with either an automation or python_script. First, enable the downloader integration in your configuration by adding the following to your configuration.yaml.

downloader:
  download_dir: downloads

Then you can use the following automation, with the entities from your system, which will save the video file under <config>/downloads/<camera_name>/<camera_name>/:

automation:
  alias: "Save the video when the doorbell is pushed"
  triggers:
  - trigger: state
    entity_id: binary_sensor.front_doorbell_ding
    to: "on"
  actions:
  - action: downloader.download_file
    data:
      url: "{{ state_attr('camera.front_door', 'video_url') }}"
      subdir: "{{state_attr('camera.front_door', 'friendly_name')}}"
      filename: "{{state_attr('camera.front_door', 'friendly_name')}}"

You may consider some modifications in the subdirectory and the filename to suit your needs. For example, you can add the date and the time and extension to the downloaded file:

    data:
      url: "{{ state_attr('camera.front_door', 'video_url') }}"
      subdir: "{{ state_attr('camera.front_door', 'friendly_name') }}/{{ now().strftime('%Y.%m') }}"
      filename: "{{ now().strftime('%Y-%m-%d-at-%H-%M-%S') }}.mp4"

the above modification will save the video file under <config>/downloads/<camera_name>/YYYY-MM/YYYY-MM-DD-at-HH-MM-SS.mp4. You can change the date according to your localization format.

If you want to use python_script, enable it your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI. [Learn more] file first:

python_script:

You can then use the following python_script to save the video file:

# obtain ring doorbell camera object
# replace the camera.front_door by your camera entity
ring_cam = hass.states.get("camera.front_door")

subdir_name = f"ring_{ring_cam.attributes.get('friendly_name')}"

# get video URL
data = {
    "url": ring_cam.attributes.get("video_url"),
    "subdir": subdir_name,
    "filename": ring_cam.attributes.get("friendly_name"),
}

# call downloader integration to save the video
hass.services.call("downloader", "download_file", data)

Event

The event entity captures events like doorbell rings, motion alerts, and intercom unlocking.

Realtime event stability

If you are experiencing issues with receiving ring alerts, the reason could be that you have too many authenticated devices on your ring account. Prior to version 2023.12.0, the Home Assistant ring integration would register a new entry in Authorized Client Devices in the Control Centre at ring.com every time it restarted. If you have been using the ring integration before this, you may have many Authorized Client Devices in the Control Centre on ring.com. This can cause issues receiving ring alerts. You should delete all authorised devices from ring.com Control Centre which are from Home Assistant (i.e. do not delete those named iPhone or Android; Home Assistant authorized devices are named ring-doorbell:HomeAssistant/something or Python). If you have too many Authorised Client Devices to delete them individually, it might be easier to Remove all devices and then re-authorize your required devices.

Sensor

Once you have enabled the Ring integration, you can start using the sensor platform. Currently, it supports battery level and Wi-Fi signal.

The volume sensors are being replaced with the number entity which allows setting the volume. You should migrate any automations using the volume sensors to the number entity by release 2025.4.0.

Siren

• Adds a siren entity for every camera that supports a siren. Note the siren will only turn on for 30 seconds before automatically turning off.
• Adds a siren entity for chimes to play the test sound.

Switch

Once you have enabled the Ring integration, you can start using the switch platform.

• Motion detection - Switches motion detection on and off for cameras.
• In-home chime - Switches on and off a mechanical or digital chime connected to a ring doorbell.

Light

Once you have enabled the Ring integration, you can start using the light platform. This will add a light for every camera that supports a light (such as a floodlight).

Number

Once you have enabled the Ring integration, you can start using the number platform. Currently, it supports showing and setting the volume of the doorbell/chime ring, intercom voice volume, and intercom microphone volume.