Skip to content

Installation

Jump to bottom
OpenGrowBox edited this page Jun 1, 2025 · 4 revisions

🌱 OpenGrowBox – Installation Guide

🔧 Requirements

  • A working Home Assistant installation (e.g., Home Assistant OS or Supervised)
  • Optional: For HACS installation, HACS must be installed and set up

🛠️ Installation via HACS (Recommended)

We got HACS Default Support!!! You can now search for the integration in HACS

📺 Install Video: Watch on YouTube

1. Open and Set Up HACS

  • In Home Assistant, go to
    Settings → Devices & Services → Integrations
  • Click Add Integration at the bottom right
  • Search for HACS and select it
  • Follow the instructions to complete setup and GitHub authentication

2. Add the OpenGrowBox-HA Repository

  • Open HACS from the sidebar
  • Go to Integrations
  • Click the ⋮ Three Dots Menu in the top right
  • Select Custom repositories
  • Enter the following URL: https://github.com/OpenGrow-Box/OpenGrowBox-HA
  • Set the category to Integration and confirm with Add

3. Install OpenGrowBox-HA

  • Search for OpenGrowBox-HA in HACS
  • Click Install
  • Wait until the installation is complete
  • Restart Home Assistant to activate the integration

4. Configure the Integration

  • After restarting, go to:
    Settings → Devices & Services
  • Add the OpenGrowBox-HA Integration and follow the setup wizard

5. Configure OpenGrowBox

  • Create a new hub to add rooms/tents
  • Restart OpenGrowBox after creating a hub
  • In the first room, you’ll find the RoomSelect sensor under Ambient (OGB_AccessToken)
  • You can either:
    • Use your own UI
    • Or use the provided OpenGrowBox UI
  • Choose and save your desired settings in OpenGrowBox

📁 Manual Installation via GitHub

1. Clone and Copy the Repository

git clone https://github.com/OpenGrow-Box/OpenGrowBox-HA.git
cd OpenGrowBox-HA
cp -r opengrowbox /config/custom_components/

💡 Note: The /config/ path may vary depending on your Home Assistant installation.

Clone this wiki locally