Skip to content

Installing on Home Assistant

GitHubGoody edited this page Jan 27, 2023 · 3 revisions

Here's a tutorial to configure Infinitude proxy container(s) using the Portainer Home Assistant add-on:

  1. Install the Portainer add-on. Home Assistant no longer officially supports the Portainer add-on, but you can install using an unofficial version using the instructions found here. Home Assistant will notify you that it's not supported, but everything including updates continue to work (i.e. you can ignore the message). Of course, you should only make the changes necessary to add the Infinitude containers (i.e. do not touch other containers) if you wish to meet the intent of the notification.
  2. Launch Portainer and continue with the applicable step (3) below...

If you intend to run a single instance of the Infinitude proxy, follow these instructions:

  1. Navigate to Containers -> Add Container
  2. Enter nebulous/infinitude:latest for the "Image"
  3. Click "Network" under "Advanced container settings" and change the network type to "host"
  4. Click "Restart Policy" and set it to "Unless Stopped"
  5. Click "Deploy the container" and continue with step (8) below

If you intend to run two or more instances of the Infinitude proxy, follow these instructions:

  1. On the left menu, click "Stacks"
  2. Click "+ Add Stack"
  3. Enter a name like "infinitude_stack" in the name field
  4. Copy/paste the following into the Web editor field, duplicate the second entry and change 3001 to 3002 as necessary for a third instance, and change the "infinitude_###" values to your preference:
version: "2.1"

services:
  infinitude_one:
    container_name: infinitude_one
    hostname: infinitude_one
    image: nebulous/infinitude:latest
    network_mode: host
    ports:
      - "3000:3000"
    volumes:
      - /mnt/data/supervisor/share/infinitude_3000/state:/infinitude/state
    environment:
      - APP_SECRET=Pogotudinal
      - PASS_REQS=300
      - MODE=Production
    restart: always

  infinitude_two:
    container_name: infinitude_two
    hostname: infinitude_two
    image: nebulous/infinitude:latest
    network_mode: bridge
    ports:
      - "3001:3000"
    volumes:
      - /mnt/data/supervisor/share/infinitude_3001/state:/infinitude/state
    environment:
      - APP_SECRET=Pogotudinal
      - PASS_REQS=300
      - MODE=Production
    restart: always
  1. Click "Deploy the stack"
  2. Set the proxy address on your thermostat(s) to the IP address of Home Assistant. Set the port to 3000 (3001 for thermostat #2, etc.)
  3. Navigate to http://ip.of.homeassistant:3000 to verify Infinitude is running and that you can see your thermostat state
  4. Install this custom component: https://github.com/MizterB/homeassistant-infinitude
  5. Configure according to these instructions. For multiple thermostats, you can have multiple list entries to look something like this:
climate:
    # Thermostat 1
  - platform: infinitude
    host: localhost
    port: 3000
    zone_names: # If your thermostat's zoning is enabled, recommend setting the zone names on the thermostat and leaving the zone entries blank (total zones must still match hyphens)
      -
      -
      -

    # Thermostat 2
  - platform: infinitude
    host: localhost
    port: 3001
    zone_names:
      - Thermostat 2 # Change to your preference
  1. Reboot your Home Assistant system (Settings > System > Hardware > 3 dots menu > Reboot system)
  2. Verify that you can now control your thermostat(s) from Home Assistant