Home Assistant (Railway Container) + Audi starter config

This repo deploys Home Assistant (Docker) on Railway and seeds an initial /config.

Railway setup

1. Deploy this repo
2. Add a Volume mounted at /config
3. Expose port 8123
4. Optional env var: TZ=America/Toronto

After first boot

1. Create your HA admin user
2. Install/configure your Audi integration in HA (UI)
3. Go to Settings → Devices & services → Helpers and set:
   • input_text.audi_soc_entity_id (ex: sensor.my_audi_state_of_charge)
   • input_text.audi_weather_entity_id (ex: weather.home) (optional)
   • input_text.audi_plugged_entity_id (optional)
4. Edit /config/secrets.yaml and set audi_vin.

What’s included

• Helpers for:
  • Charge mode (STRICT vs SMART), window, days, target SOC, departure time, estimated charge rate, cold-temp correction
• Scripts:
  • Start/stop charge
  • Lock/unlock (if supported by your Audi integration)
  • Start preheat (basic)
• Automation:
  • Enforces charge behavior every 10 minutes (calls start/stop only when needed)

Migration to Raspberry Pi (Home Assistant OS)

Copy the whole /config directory from Railway volume to the Pi’s /config, then reboot HA.