# Connect pvnode with ioBroker

[ioBroker](https://www.iobroker.net/) is an open-source IoT platform. The
community adapter `pvforecast` supports pvnode as a forecast source and exposes
the forecast as objects for your scripts and automations.

:::note
**V1 or V2?** The adapter has a **Use pvnode API v2** checkbox for the V2 API.
Without it, it runs on the V1 API, which will be **shut down on 31 Dec 2026** —
see [Migration from V1](/en/v2/migration).
:::

## Setup

1. **Create a site.** Create your [site](https://pvnode.com/sites/new) with all
   its PV strings (orientation, tilt, peak power) once in pvnode and copy the
   `site_id`. No geometry settings are needed in the adapter after that
   ([Sites & Strings](/en/v2/api/sites)).
2. **Get an API key** at [API keys](https://pvnode.com/settings/api-keys).
3. **Configure the adapter:**

| Field              | Value                                                        |
|--------------------|--------------------------------------------------------------|
| API key            | your pvnode API key                                          |
| Use pvnode API v2  | enable                                                       |
| pvnode site ID     | `site_xxxxxxxxxxxxxxxxxxxxxx`                                |
| Subscription tier  | Free / Light / Plus — sets the polling interval automatically |
| Forecast days      | Free: max. 2 (today + tomorrow), Light/Plus: max. 7           |

The **plant table** needs at least one entry. The adapter maps the site's strings
by position (plant 1 → string 0, plant 2 → string 1, …), giving you true
per-plane forecasts. If no string data is available, the site total is stored
under the first plant.

## Further options

All remaining settings are documented by the adapter:

**[→ pvforecast adapter in the ioBroker documentation](https://github.com/iobroker-community-adapters/ioBroker.pvforecast/blob/main/docs/en/README.md)**