HomeAssistant Integration

After having installed RaspberryMatic either as a native Home Assistant Add-on or as a sole standalone CCU operating system Home Assistant (HA) can be additionally used as a third-party smarthome automation central by connecting it directly to a HomeMatic CCU including RaspberryMatic. This will then allow to control all your HomeMatic/homematicIP devices directly from Home Assistant and also use all the different automation possibilities Home Assistant provides.

The following documentation explains how to setup the HomeMatic/homematicIP Integration within Home Assistant as soon as you have RaspberryMatic correctly running either as a HA Add-on or as a standalone CCU system.

Home Assistant Community Store (HACS) Setup

To be able to bind/connect your Home Assistant installation to a CCU/RaspberryMatic system the so-called Home Assistant Community Store (HACS) has to be previously installed so that HomeMatic/homematicIP devices can be integrated into your HA installation. The following step will quickly guide you through the process of setting up HACS within your existing Home Assistant installation:

1. Enable 'Advanced Mode' in HA: As a first step, make sure you have the Advanced Mode enabled in your Home Assistant setup. This is required for the next coming step where you will have to install a SSH Add-on to install HACS afterwards. To do so, click your username in the bottom-left corner of the Home Assistant web interface, then scroll down until you find Advanced Mode:
2. Install 'SSH & Web Terminal' Add-on: To be able to install HACS you need a possibility to execute a command within the context of Home Assistant. For this you should have a SSH Terminal session Add-on installed. Preferably, you can install the SSH & Web Terminal Add-on from the Community Add-on section. To do so, go to Configuration -> Add-ons -> Add-on Store and search for 'SSH'. Then select the SSH & Web Terminal Add-on and install it accordingly:
3. Setup SSH Password: Once the SSH Add-on is installed make sure to switch to the Configuration tab of the Add-on and then setup either an authorized SSH key or dedicated password for being able to connect via SSH:
4. Open SSH Add-on Web UI: Afterwards make sure to start the new SSH Add-on and then open the Web UI of the Add-on so that you will be forwarded to a terminal session within Home Assistant:
5. Execute HACS Installation: Once the terminal session to your HA is established, you have to enter the following command-line and execute it to execute the HACS installation:

   wget -O - https://get.hacs.xyz | bash -

   
6. Restart Home Assistant: To finalize the HACS installation, make sure to reboot your Home Assistant installation, preferably by rebooting your whole Home Assistant host or just the core engine:
7. Add new 'HACS' integration: After the successful restart of Home Assistant make sure to change to Configuration -> Devices & Services and press + Add integration. In the integration list, make sure to search for HACS and then select it accordingly. Once you are going to install the new integration make sure to tick all checkboxes you may be asked so that you understand the deal when using HACS:
8. Install HACS integration: To be able to install and use the new HACS integration, make sure to authenticate it using your github.com account since the whole HACS functionality heavily relies on github to be used as a repository service:
9. Access HACS UI: After successful installation of the new HACS integration a new HACS top-level item in your HA menubar should appear, which means that HACS is now correctly installed:
10. Finalized HACS Setup: To finalize the HACS setup you will have to make sure to perform a final restart of Home Assistant by using Configuration -> Settings -> Check Configuration first and then press Restart afterwards to make sure that Home Assistant will be restarted a last time: Warning: After a fresh HACS installation/setup you will have to keep your Home Assistant running for about 10-15 minutes so that HACS can fetch all necessary third-party repository information from github. Depending on your connection speed and github use, this can take a long time until HACS has correctly fetched all necessary information in the background.