Home Assistant Integration

Connect Restlos to your smart home and use your inventory data for automations, dashboards, and more.

Overview

The Home Assistant integration allows you to integrate your Restlos data into your smart home. The app automatically sends sensor data to Home Assistant, which you can use for dashboards, automations, and notifications.

Automatic Sync

Your data is automatically sent to Home Assistant

Comprehensive Sensors

Item count, inventory value, expiring items, and more

Prepare Home Assistant

Create Access Token

Open your Home Assistant
Go to Profile (click your username in the bottom left)
Scroll down to "Long-Lived Access Tokens"
Click "Create Token"
Enter a name (e.g., "Restlos") and click "OK"
Copy the displayed token (important: it will only be shown once!)

⚠️ Important: Store the token safely. It will only be displayed once!

Configure Restlos App

Open the Restlos App on your iPhone/iPad
Go to Settings → "Home Assistant"
Enable "Activate Home Assistant"
Enter your Home Assistant URL:
- http://192.168.1.100:8123 (local network)
- https://ha.yourdomain.com (external)
Paste your Access Token
Tap "Connect"

💡 Tip: If you have connection issues, verify the URL and ensure Home Assistant is reachable from your iPhone.

Available Sensors

After successful connection, the following sensors will be created automatically:

`sensor.iphone_restlos_total_items`

Total count of all items in inventory

`sensor.iphone_restlos_unique_products`

Number of unique products

`sensor.iphone_restlos_locations`

Number of storage locations used

`sensor.iphone_restlos_total_value`

Estimated total inventory value in €

`sensor.iphone_restlos_expiring_today`

Number of items expiring today

`sensor.iphone_restlos_expiring_tomorrow`

Number of items expiring tomorrow

`sensor.iphone_restlos_expiring_week`

Number of items expiring this week

`sensor.iphone_restlos_next_expiring`

List of next 5 expiring items (as attribute)

Create Dashboard

Create a dashboard to visualize your Restlos data. Here's an example YAML:

type: vertical-stack
cards:
  # Overview Cards
  - type: horizontal-stack
    cards:
      - type: entity
        entity: sensor.iphone_restlos_total_items
        name: Total Items
        icon: mdi:package-variant
      - type: entity
        entity: sensor.iphone_restlos_unique_products
        name: Products
        icon: mdi:food-apple
      - type: entity
        entity: sensor.iphone_restlos_locations
        name: Locations
        icon: mdi:home-group

  # Inventory Value
  - type: entity
    entity: sensor.iphone_restlos_total_value
    name: Inventory Value
    icon: mdi:currency-eur

  # Expiring Items
  - type: glance
    title: Expiring Items
    entities:
      - entity: sensor.iphone_restlos_expiring_today
        name: Today
      - entity: sensor.iphone_restlos_expiring_tomorrow
        name: Tomorrow
      - entity: sensor.iphone_restlos_expiring_week
        name: This Week

  # Next Expiring Items
  - type: markdown
    title: Next Expiring Items
    content: >-
      {% for item in state_attr('sensor.iphone_restlos_next_expiring',
      'items') %}
        **{{ item.product }}** - {{ item.location }}  
        Expires: {{ item.expiry_date }} ({{ item.days_until }} days)  
        ---
      {% endfor %}

💡 How to use this YAML:

Open Home Assistant
Go to Overview → "Edit Dashboard"
Click "+ Add Card"
Select "Manual"
Paste the YAML and click "Save"

Example Automations

Notification for Expiring Items

Receive a notification when items expire today:

alias: Restlos - Expiring Items Notification
description: Notification when items expire today
trigger:
  - platform: time
    at: "08:00:00"
condition:
  - condition: numeric_state
    entity_id: sensor.iphone_restlos_expiring_today
    above: 0
action:
  - service: notify.mobile_app_iphone
    data:
      title: "⏰ Items expiring today!"
      message: >-
        {{ states('sensor.iphone_restlos_expiring_today') }} 
        items are expiring today. Check Restlos!
mode: single

LED Warning for Many Expiring Items

Change the color of a light when many items expire this week:

alias: Restlos - Week Warning LED
description: LED red when many items expire this week
trigger:
  - platform: numeric_state
    entity_id: sensor.iphone_restlos_expiring_week
    above: 5
action:
  - service: light.turn_on
    target:
      entity_id: light.kitchen_light
    data:
      rgb_color:
        - 255
        - 0
        - 0
      brightness: 100
mode: single

Troubleshooting

🔴 Sensors don't appear

Check if the URL is correct (with http:// or https://)
Ensure the Access Token is valid
Verify network connection
Wait a few minutes - first sync may take some time

🔴 Connection error

For external URL: Check if HTTPS is configured correctly
For local URL: Ensure you're on the same network
Check firewall rules

🔴 Data not updating

The app syncs automatically when changes occur
Check if integration is still active in settings
Open the app and wait briefly - sync should start

Need help? Contact us via Support