Installation

Installation & Configuration Guide 🚀⚙️

This page provides a step-by-step guide to installing, configuring, and updating the Bosch Indego custom integration in Home Assistant.

---

📦 Step 1: Installation via HACS

The recommended method for installing and maintaining this integration is through the Home Assistant Community Store (HACS).

1. Open your Home Assistant frontend and navigate to HACS.
2. Click on Integrations in the main panel.
3. Click the three dots ... in the top right corner and select Custom repositories.
4. Paste the URL of your repository copy into the Repository field.
5. Select Integration as the category and click Add.
6. Search for Bosch Indego Mower inside HACS, click on it, and select Download.
7. Crucial: Restart your Home Assistant core instance to load the newly downloaded custom component files into the runtime memory buffer.

---

⚙️ Step 2: UI Configuration & Authentication Loop

This integration features an easy-to-use configuration wizard built directly into the Home Assistant Integration UI.

1. Navigate to Settings $\rightarrow$ Devices & Services inside Home Assistant.
2. Click + Add Integration in the bottom right corner.
3. Search for Bosch Indego Mower and select it.
4. A configuration dialog prompt will appear requesting your account context:
   • Username: The email address bound to your official Bosch Smart Gardening smartphone application profile.
   • Password: The password associated with your Bosch ID context.
5. Submit the credentials. The integration backend automatically establishes an asynchronous secure login sequence matching the reverse-engineered Android OpenID Connect browser flow (POST /api/v1/authenticate?boschid).
6. Once the OAuth2 context yields a valid Bearer token array, the integration automatically probes for paired mowers (GET /api/v1/users/{userId}) and downloads the asset parameters.

---

🔧 Advanced Customization (configuration.yaml)

While the core installation runs completely through the integration UI, you can fine-tune global performance values and logging behaviors inside your local