Home Assistant (HACS Integration)

Integrating OliveTin with Home Assistant allows you to control OliveTin from your Home Assistant dashboard. Using the HACS integration is the recommended way to integrate OliveTin with Home Assistant. It is easy to set up and provides a seamless experience.

If you are not familiar with HACs, it is a custom component for Home Assistant that allows you to install and manage custom integrations easily. It is similar to the Home Assistant Add-ons store but for integrations.

Setup guide

  1. Install HACS

  2. Go to HACS in your home assistant control panel. Click the "…​" dropdown in the top right corner, and select "Custom Repositories".

    hacs dropdown
  3. In the dialog that pops up, add the custom repo as follows;

    hacs custom repo
    1. Repository link: https://github.com/OliveTin/OliveTin-HomeAssistant

    2. Type: Integration

  4. Search for "OliveTin" in the HACS store, and download it. You will probably need to restart Home Assistant for it be registered correctly.

    hacs search
    hacs download
  5. Go to "Settings" and open "Devices & Services"

    hass devices and services
  6. Click "Add integration" and search for "OliveTin". Note that if it does not show up, you may need to restart Home Assistant.

    hass add integration
    1. Select "OliveTin"

    2. Host: http://your-server:1337/api

    3. Username: <blank>

    4. Password: <blank>

  7. Under "Configured", you should see OliveTin. Open it by clicking on the arrow.

    hass configure integration

  8. After configuring it, you should see buttons appear in Home Assistant;

    hass buttons