Source: https://spooly.eu/en/docs/home-assistant/installation

# Installation

Spooly comes to Home Assistant through the Marketplace from 2026.11 and through HACS up to 2026.10. The button opens the right place in your instance.

## With the button

[Open in Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=Blanus-1&repository=spooly-homeassistant&category=integration)

1. Tap “Open in Home Assistant”. The button dates from the HACS days: up to Home Assistant 2026.10 it shows Spooly in HACS, since 2026.11 it opens the Marketplace. If Spooly is not listed there, use the “Without the button” way below.
2. Install Spooly and restart Home Assistant.
3. Continue with the [setup](https://spooly.eu/en/docs/home-assistant/configuration).

The button works through [My Home Assistant](https://my.home-assistant.io).

## Without the button, in the Marketplace (2026.11 and newer)

Since Home Assistant 2026.11 HACS is built in as the “Marketplace”, so you no longer install HACS separately. If you already used HACS, Home Assistant carries your repositories over on the first start after the update.

1. Open Settings › Marketplace. The first time, Home Assistant asks you to accept a warning about community content.
2. Select “Add from link” in the upper-right corner and enter the address below under “GitHub link”. Confirm with “Add”.
3. If Home Assistant asks you to connect GitHub, follow the steps in the dialog. The Marketplace needs it to add custom repositories.
4. If the Marketplace does not recognize the type, choose “Integration” and confirm again.
5. Open Spooly in the list, install it and restart Home Assistant.

Repository:

```
https://github.com/Blanus-1/spooly-homeassistant
```

The steps follow the [Home Assistant Marketplace docs](https://www.home-assistant.io/integrations/marketplace/#custom-repositories).

## Without the button, through HACS (2026.10 and older)

1. Open HACS and add a custom repository, type Integration.
2. Enter the address below, install Spooly and restart Home Assistant.

Repository:

```
https://github.com/Blanus-1/spooly-homeassistant
```

## By hand

Download version 0.3.0 from [GitHub](https://github.com/Blanus-1/spooly-homeassistant/releases). Copy the folder `custom_components/spooly` into your configuration directory, where `configuration.yaml` lives, and restart Home Assistant.