Infinitude runs as a Docker container on your Home Assistant instance, proxying traffic between your thermostat and Carrier's servers. The Infinitude Beyond custom component provides native Home Assistant integration.

Using Portainer (install from alexbelgium/hassio-addons):

1. Navigate to Containers -> Add Container
2. Image: nebulous/infinitude:latest
3. Network: set to host
4. Restart Policy: Unless Stopped
5. Deploy

Or via SSH / Terminal & SSH add-on:

docker run -d \
  --name infinitude \
  --restart unless-stopped \
  --network host \
  -v /mnt/data/supervisor/share/infinitude/state:/infinitude/state \
  -e APP_SECRET='your-secret-here' \
  -e PASS_REQS='300' \
  nebulous/infinitude

In Portainer Stacks, create a stack with:

version: "2.1"

services:
  infinitude_one:
    container_name: infinitude_one
    hostname: infinitude_one
    image: nebulous/infinitude:latest
    network_mode: host
    volumes:
      - /mnt/data/supervisor/share/infinitude_3000/state:/infinitude/state
    environment:
      - APP_SECRET=your-secret-here
      - 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=your-secret-here
      - PASS_REQS=300
      - MODE=Production
    restart: always

On each thermostat wall control:

1. Open Wi-Fi menu -> Advanced Settings -> Proxy
2. Set "Use Proxy Server" to Yes
3. Set proxy server address to your Home Assistant IP
4. Set proxy port to 3000 (3001 for second thermostat, etc.)

Verify by navigating to http://<HA-IP>:3000 in a browser.

The actively maintained Infinitude Beyond custom component adds proper Home Assistant support including config flow:

1. Install via HACS (Home Assistant Community Store):
   • Add the repository as a custom integration in HACS
   • Or download and place in custom_components/infinitude_beyond/
2. Restart Home Assistant
3. Go to Settings > Devices & Services > Add Integration
4. Search for "Infinitude Beyond"
5. Enter your Infinitude host and port (e.g., localhost:3000)
6. Follow the config flow to set up your zones

This replaces the legacy YAML-based infinitude platform.

The older homeassistant-infinitude integration uses YAML configuration. For multiple thermostats:

climate:
    # Thermostat 1
  - platform: infinitude
    host: localhost
    port: 3000
    zone_names:
      -
      -
      -

    # Thermostat 2
  - platform: infinitude
    host: localhost
    port: 3001
    zone_names:
      - Thermostat 2

Note: The legacy integration is superseded by Infinitude Beyond, which uses the modern config flow approach.

After setup, check that you can:

• See thermostat state at http://<HA-IP>:3000
• Control temperature from Home Assistant's climate entity
• See zone temperatures, humidity, and mode in HA dashboard