Installation

Installation & Configuration Guide 🚀⚙️

This guide covers everything you need to install, configure, and maintain the Bosch Indego integration in Home Assistant.

---

📦 Prerequisites

Before you start, make sure you have:

• Home Assistant (Core, Container, or OS) – version 2024.1 or newer recommended.
• HACS (Home Assistant Community Store) – optional but highly recommended.
• A Bosch ID account with at least one Indego mower already paired in the official Bosch Indego Connect app.
• Google Chrome browser (required only for the initial OAuth authentication flow).

💡 If you don’t have HACS, follow the manual installation steps.

---

🔧 Step 1: Install the Browser Extension (Required for Auth)

Bosch Indego uses Bosch SingleKey ID (OAuth2 via OpenID Connect). The integration needs a small browser extension to capture the authentication redirect.

1. Download the helper extension: browser-extension.zip
2. Extract the ZIP file to a folder on your computer.
3. Open your browser's extension management page:
   • Chrome / Edge / Brave / Opera / Vivaldi / Arc: chrome://extensions or edge://extensions
   • Firefox: about:debugging#/runtime/this-firefox
4. Enable Developer mode (Chromium browsers only).
5. Click Load unpacked (Chromium) or Load Temporary Add-on (Firefox) and select the extracted folder.
6. ✅ The extension is now installed. You can disable or remove it after the first successful authentication.

Supported browsers: All Chromium-based browsers (Chrome, Edge, Brave, Opera, Vivaldi, Arc, Thorium, and more) + Firefox

📖 Full list of Chromium-based browsers

---

📥 Step 2: Install the Integration

Option A – Via HACS (Recommended)

1. Open Home Assistant and go to HACS → Integrations.
2. Search for Bosch Indego Mower in the HACS integrations list.
3. Click Download.
4. Restart Home Assistant when prompted.

Option B – Manual Installation (without HACS)

1. Download the latest release from the GitHub Releases page.
2. Extract the archive and copy the boschindego folder into your custom_components directory.
   • Typical path: /config/custom_components/boschindego
3. Restart Home Assistant.

---

🔐 Step 3: Add the Integration to Home Assistant

1. Go to Settings → Devices & Services.
2. Click the + Add Integration button (bottom‑right corner).
3. Search for Bosch Indego Mower and select it.
4. Enter your Bosch ID credentials (email and password – same as used in the official Bosch Indego app).
5. Click Submit – a new browser window/tab will open to the Bosch ID login page.
6. Log in with your credentials (if not already logged in).
7. After successful login, the extension will automatically redirect you back to Home Assistant.
8. ✅ The integration will now discover your paired mower(s). No further manual configuration is required.

Multiple mowers? You can add the integration once for each mower – simply repeat steps 3–7.

---

⚙️ Step 4: Optional Configuration & Tuning

After the integration is added, you can fine‑tune its behaviour.

1. Go to Settings → Devices & Services → find the Bosch Indego Mower card.
2. Click Configure.

Option	Description	Default
Custom User Agent	Change this if Bosch Cloud blocks requests (try HomeAssistant/Indego or HA/Indego).	HomeAssistant/Indego
Expose as Lawn Mower	Enables the native Home Assistant lawn_mower entity (recommended for new automations).	Enabled
Expose as Vacuum	Enables the legacy vacuum entity for backward compatibility.	Disabled
Show All Alerts	Store the complete alert history as entity attributes. Use sparingly – increases registry size.	Disabled

💡 After changing any option, the integration will restart automatically.

---

🧪 Step 5: Verify Everything Works

After installation and configuration, all entities appear as unused entities by default.

1. Go to Settings → Devices & Services → Entities.
2. Filter by indego to see all created entities.
3. Add the ones you care about to your dashboard or automations.

Core entities you should see:

Entity ID example	Description
sensor.indego_12345678_mower_state	Current human‑readable state
sensor.indego_12345678_battery_percentage	Battery level
binary_sensor.indego_12345678_online	Online / offline status
binary_sensor.indego_12345678_alert	Active alerts (with detailed attributes)
switch.indego_12345678_smartmowing	Toggle SmartMowing
camera.indego_12345678_lawn_map	SVG lawn map with live position (if map exists)
lawn_mower.indego_12345678	Native lawn mower entity (if enabled)
vacuum.indego_12345678	Legacy vacuum entity (if enabled)

If you do not see any entities after 5 minutes:

• Check the integration logs: Settings → System → Logs → filter by custom_components.indego.
• Enable debug logging (see Troubleshooting below).

---

🔄 Updating the Integration

Via HACS

1. Go to HACS → Integrations.
2. Find Bosch Indego Mower – if an update is available, an Update button will appear.
3. Click Update and then restart Home Assistant.

Manual update

1. Download the latest release from GitHub Releases.
2. Replace the contents of custom_components/indego with the new files.
3. Restart Home Assistant.

📌 Always restart Home Assistant after updating the integration.

---

🐛 Troubleshooting

Authentication fails / “Login required” loop

• Make sure the Chrome extension is installed and enabled.
• Clear your browser cookies for accounts.bosch.com and retry.
• Ensure your Bosch account is active and has at least one mower paired in the official app.
• Try disabling any ad‑blockers or privacy extensions temporarily.

Entities remain “unavailable” or mower shows offline

• Check binary_sensor.indego_<SERIAL>_service_status – if it shows OFF, the Bosch Cloud is having issues (HTTP 5xx). This usually resolves itself within minutes.
• If the mower shows state 802 (WiFi lost) or 803/804 (connection errors), check your mower’s cellular/WiFi connectivity.
• Enable debug logging:

  # configuration.yaml
  logger:
    logs:
      custom_components.indego: debug
      pyIndego: debug

Restart Home Assistant and observe the logs in Settings → System → Logs.

HTTP 4xx errors (blocked requests)

Bosch Cloud may occasionally block certain User‑Agent strings. Solution: Change the Custom User Agent in the integration configuration to one of these alternatives:

• HomeAssistant/Indego
• HA/Indego
• IndegoHA/1.0 Save and wait a few minutes – the error should clear.

Commands (mow/pause/dock) have no effect

Check sensor.indego_<SERIAL>_mower_state_detail – the mower may be in an error state or already docked. If you see 12292 (PIN not set) in the error code, set a PIN on the mower display first. Try sending the command again after 30 seconds (the mower may be busy with a firmware update or learning phase).

Map camera shows blank / no image

Ensure a garden map has been created in the official Bosch Indego app first. The map is only available if the mower has completed at least one full learning run. Use the service indego.download_map to force a fresh map download.

---

❓ Getting Help

If you still have issues after following this guide:

1. Search existing issues – GitHub Issues
2. Open a new issue – include:
   • Home Assistant version
   • Integration version
   • Mower model
   • Debug logs (with custom_components.indego: debug enabled)
   • Any relevant error messages
3. Join our Discord – Invite link for faster community support

---

✅ Supported Mower Models

The integration works with all Bosch Indego models that use the Bosch Indego Connect cloud service, including:

Series	Models
1000 series	Indego 1000, 1100, 1200
C series	Indego 10C, 13C
300/400 series	Indego 350, 400
S+ series	S+ 350 (1st/2nd Gen), S+ 400 (1st/2nd Gen), S+ 500
M+ series	M+ 700 (1st/2nd Gen)

If your model is not listed but works with the official app, please open an issue to add it to the list.