Tandoor on Home Assistant

Tandoor Recipes in Home Assistant Sidebar

Tandoor Recipes in the Home Assistant Sidebar

May 17, 2026  ·  5 min read

This guide shows how to embed Tandoor Recipes directly into the Home Assistant sidebar — including remote access through Nabu Casa — with automatic single sign-on using your HA account.

Step 1 — Add the alexbelgium add-on repository

  1. In HA go to Settings → Add-ons → Add-on Store.
  2. Click the ⋮ menu (top right) → Repositories.
  3. Paste the URL below and click Add:
https://github.com/alexbelgium/hassio-addons

Step 2 — Install Tandoor Recipes

  1. Refresh the add-on store and search for Tandoor Recipes.
  2. Click it → Install. Wait for it to finish.
  3. Do not start it yet — configure it first.

Step 3 — Configure the add-on

Open the add-on's Configuration tab and set the following:

ALLOWED_HOSTS

Add your Home Assistant's local IP address:

192.168.1.X

Environment variables

Add these two entries under env_vars (or equivalent field):

REMOTE_USER_AUTH=1

This tells Tandoor to trust the Remote-User HTTP header for authentication — Home Assistant will inject your username automatically.

SECRET_KEY

Generate a random secret key by running this in any terminal:

python3 -c "import secrets; print(secrets.token_urlsafe(50))"

Copy the output and paste it into the SECRET_KEY field.

Save the configuration, then Start the add-on. Note the port shown in the Info tab — you'll need it in Step 5.

Step 4 — Install hass_ingress from HACS

  1. Open HACS → Integrations → ⋮ menu → Custom repositories.
  2. Paste this URL, set category to Integration, and click Add:
https://github.com/lovelylain/hass_ingress
  1. Search for hass_ingress in HACS and install it.
  2. Restart Home Assistant.

Step 5 — Add the ingress block to configuration.yaml

Open /homeassistant/configuration.yaml and append the block below. Replace 192.168.1.X with your HA's IP and 9928 with the port shown on the Tandoor add-on's Info tab. 

ingress:
  tandoor_recipes:
    work_mode: ingress
    title: Tandoor Recipes
    icon: mdi:silverware-fork-knife
    url: http://192.168.1.X:9928
    index: /
    headers:
      Remote-User: $username
    rewrite:
      - mode: body
        match: /(static|media)/
        replace: $http_x_ingress_path/\1/
      - mode: body
        match: ="/admin/
        replace: ="$http_x_ingress_path/admin/
      - mode: header
        name: Location
        match: ^/(.*)
        replace: $http_x_ingress_path/\1
      - mode: body
        match: <head>
        replace: <head><base href="$http_x_ingress_path/">
Why the rewrites?
Home Assistant serves Tandoor's Vue SPA under a prefixed path (/api/ingress/tandoor_recipes/). The three rules fix static asset URLs, redirect headers, and inject a <base href> tag so the frontend constructs all API URLs correctly.

Save the file and Restart Home Assistant. Tandoor Recipes will appear in your sidebar and work over Nabu Casa with no port forwarding needed.