mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-30 23:06:49 +00:00
63 lines
1.9 KiB
Markdown
63 lines
1.9 KiB
Markdown
---
|
|
title: Ubiquiti UniFi Video
|
|
description: Instructions on how to integrate UVC cameras within Home Assistant.
|
|
ha_category:
|
|
- Camera
|
|
ha_release: 0.13
|
|
ha_iot_class: Local Polling
|
|
ha_domain: uvc
|
|
---
|
|
|
|
The `uvc` camera platform allows you to integrate [UniFi Video Camera (UVC)](https://www.ubnt.com/products/#unifivideo) into Home Assistant.
|
|
|
|
The platform connects to the UniFi NVR software and automatically discovers/adds any camera connected to the NVR.
|
|
|
|
### Setup
|
|
|
|
It is recommended that you create a new user for this platform in the NVR software and only give the user the permissions it need to operate.
|
|
|
|
- The API key is found in `User` -> `My account` -> `API Access` in the NVR software.
|
|
- The camera password is found in `Settings` -> `Camera Settings` -> `Camera Password` in the NVR software.
|
|
|
|
### Configuration
|
|
|
|
To enable, add the following to your `configuration.yaml` file:
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
camera:
|
|
- platform: uvc
|
|
nvr: IP_ADDRESS
|
|
key: API_KEY
|
|
```
|
|
|
|
{% configuration %}
|
|
nvr:
|
|
description: The IP or hostname of the NVR (Network Video Recorder) server.
|
|
required: true
|
|
type: string
|
|
port:
|
|
description: The port number to use for accessing the NVR.
|
|
required: false
|
|
type: integer
|
|
default: 7080
|
|
key:
|
|
description: The API key available from the NVR web interface.
|
|
required: true
|
|
type: string
|
|
password:
|
|
description: The camera password.
|
|
required: false
|
|
type: string
|
|
default: ubnt
|
|
ssl:
|
|
description: Should use SSL/TLS to connect to the NVR.
|
|
required: false
|
|
type: boolean
|
|
default: false
|
|
{% endconfiguration %}
|
|
|
|
<div class='note'>
|
|
When using an API_KEY to access cameras controlled by Ubiquiti's NVR Software, the associated user account MUST have at least Administrator privileges within the NVR Software in order for new cameras to be added into Home Assistant. Once the entities have been created in Home Assistant, privileges for the user account can be lowered.
|
|
</div>
|