Kör EnergyWizard bakom din egen Home Assistant-adress

Installation, avancerat

Har du Home Assistant OS eller Supervised? Använd då HA:s egen Ingress istället - installera EnergyWizard som ett tillägg och du får auth/TLS/routing helt gratis, enklare och säkrare än allt nedan. Den här guiden är för Container-installationer UTAN Supervisor (det vanligaste sättet att köra HA i vanlig Docker) - Ingress finns inte där, så det här är den enda vägen till samma sak: EnergyWizard under exakt samma adress som din HA.

Vad det ger dig

En ny, valfri ha-gateway-tjänst i EnergyWizards egen docker-compose.yml som slår ihop din Home Assistant och EnergyWizard under samma adress: allt annat går vidare till din riktiga HA, /energywizard går till webbdashboarden, /energywizard/mobil och /tablet går till mobilappen.

Två giltiga slutlägen - välj det som passar dig:

Egen port (enklast, rekommenderas för de flesta): låt gatewayn ligga kvar på sin egen port (t.ex. 8199) bredvid din HA, som alltid förblir på 8123 - exakt samma mönster som andra fristående tjänster (t.ex. Familjetavlan). Rör ALDRIG HA:s egen konfiguration. Stega bara igenom Steg 1-2 nedan, hoppa över Steg 3.
Exakt samma port som HA (Steg 3, mer jobb): flytta HA:s egen port åt sidan så gatewayn kan ta över 8123 helt - kräver att du själv ändrar HA:s konfiguration och startar om ditt styrsystem. Bara värt besväret om du verkligen vill ha EXAKT samma adress/port som HA, inte bara samma domän.

Steg 1 - konfigurera

Lägg till i din .env (exempel finns i .env.example):

HA_GATEWAY_DOMAIN=din-domän.se
HA_GATEWAY_CERT_DIR=/sökväg/till/din/cert-mapp
HA_GATEWAY_UPSTREAM_HOST=192.168.1.X   # din HA:s lokala IP
HA_GATEWAY_UPSTREAM_PORT=8123
HA_GATEWAY_UPSTREAM_PROTO=https        # http om din HA inte terminerar egen TLS
HA_GATEWAY_PORT=8199                   # din egen port - kan vara permanent (se ovan)

HA_GATEWAY_CERT_DIR måste innehålla riktiga fullchain.pem/privkey.pem-filer. Använder du Certbot kan dessa vara symlänkar som pekar utanför mappen (vanligt) - då räcker inte en enkel mappmontering. Lös det med en lokal docker-compose.override.yml (checkas aldrig in, se .gitignore) som monterar de faktiska filerna direkt:

services:
  ha-gateway:
    volumes:
      - /sökväg/till/archive/dindomän/fullchain1.pem:/certs/fullchain.pem:ro
      - /sökväg/till/archive/dindomän/privkey1.pem:/certs/privkey.pem:ro

Steg 2 - starta och testa

docker compose --profile ha-gateway up -d ha-gateway och besök https://din-nuc-ip:8199/ (ska visa din vanliga HA- inloggning) och /energywizard/ (ska visa EnergyWizard), inklusive att logga in i EnergyWizard och att HA:s live-uppdateringar (klicka runt lite) fungerar som vanligt. Klart - vill du ha egen port som slutläge (rekommenderas) är du redan klar här, hoppa över Steg 3.

Steg 3 (valfritt, mer jobb) - flytta HA:s egen port (gör du SJÄLV, manuellt)

EnergyWizards installation rör aldrig din HA:s egen konfiguration - det gör du själv, i HA:s eget gränssnitt (Inställningar → System → Nätverk, kräver att "Avancerat läge" är påslaget på din användarprofil). Flytta HA:s "server port" bort från 8123 (t.ex. till 8124) och spara - HA startar om. Sätt sen HA_GATEWAY_UPSTREAM_PORT till samma nya port och HA_GATEWAY_PORT till 8123, och starta om gatewayn. Nu är din-domän.se:8123 gatewayn, som i sin tur pratar med din HA på den nya interna porten.

Säkerhetsnät: testa noga innan du stänger några andra vägar till din HA (mobilappen, ev. röstassistenter) - de pekar ofta hårdkodat mot den gamla porten och behöver uppdateras. Gör ändringen när du har gott om tid att felsöka på plats, inte precis innan du ska ut.