---
layout: default
title: Installation
nav_order: 2
---

# Installation

## Step 1: Download the Integration

Download or clone this repository to get the integration files.

```bash
git clone https://github.com/your-username/rdz_innova_heatpump.git
```

## Step 2: Copy Integration Files

Copy the `custom_components/rdz_innova_heatpump` folder to your Home Assistant `custom_components` directory.

```
<config_directory>/
└── custom_components/
    └── rdz_innova_heatpump/
        ├── __init__.py
        ├── climate.py
        ├── sensor.py
        ├── binary_sensor.py
        ├── water_heater.py
        ├── config_flow.py
        ├── manifest.json
        └── translations/
            └── en.json
```

![File Structure](assets/images/file-structure.png)
*Expected file structure after installation*

## Step 3: Restart Home Assistant

After copying the files, restart Home Assistant completely. This is required for Home Assistant to detect the new integration.

![Restart Home Assistant](assets/images/restart-ha.png)
*Restart Home Assistant from Settings > System*

## Step 4: Add Integration

1. Go to **Settings** > **Devices & Services**
2. Click **+ Add Integration** button
3. Search for "RDZ" or "Heat Pump Monitor"

![Search Integration](assets/images/search-integration.png)
*Search for the integration in the Add Integration dialog*

4. Select "Heat Pump Monitor" from the results
5. Follow the configuration wizard (see [Configuration](configuration.md))

![Add Integration](assets/images/add-integration.png)
*The integration should appear in search results*

## Step 5: Verify Installation

After configuration, you should see:
- A new device "Heat Pump" in your devices list
- Multiple entities (sensors, binary sensors, climate, water heater)

![Device Overview](assets/images/device-overview.png)
*Device overview showing all entities*

## Next Steps

- [Configure the integration](configuration.md)
- [Set up the dashboard](dashboard.md)

## Troubleshooting Installation

If the integration doesn't appear:

1. Verify files are in the correct directory
2. Check Home Assistant logs for errors
3. Ensure you restarted Home Assistant completely (not just reload)
4. See [Troubleshooting](troubleshooting.md) for more help