Updated readme to include Proxy setup in home-assistant configuration.yaml

This commit is contained in:
Jørgen Ferdinand 2025-05-20 22:23:52 +02:00
parent eab9375321
commit 8c904031a8
5 changed files with 250 additions and 0 deletions

View file

@ -54,6 +54,55 @@ The following environment variables are passed to the `Newt` container:
---
### 🛡️ Reverse Proxy / `trusted_proxies` Setup (Optional)
#### 📘 Step-by-Step Instructions
1. Open your `configuration.yaml` file (usually located in `/config`).
2. Add or update the `http:` section to include `use_x_forwarded_for` and `trusted_proxies`:
```yaml
http:
use_x_forwarded_for: true
trusted_proxies:
- 172.30.33.0/24 # Default range for Home Assistant add-ons
- 127.0.0.1 # Localhost (if relevant)
- 192.168.1.100 # Example: IP of your reverse proxy or VM host
```
🔎 How to Find Your Add-on or Proxy IP
If you're unsure of the IP range your add-on or reverse proxy uses, you can inspect the Docker network:
```bash
docker network inspect hassio
```
Look under the "Containers" section to find the IP of your Newt add-on or proxy.
✅ When to Use This
You need this setup if:
You're using a reverse proxy (e.g., NGINX, Traefik).
Your add-on or proxy accesses Home Assistant via internal IP (e.g., 172.30.x.x).
You're seeing token errors or "403: Forbidden" in the logs.
🔄 Final Step
After editing configuration.yaml, restart Home Assistant for the changes to take effect:
Go to Settings → System → Restart
or
Run via CLI:
```sh
ha core restart
```
---
## 🔍 Troubleshooting
💡 **Add-on does not start?**
- Check the logs in Home Assistant (`Settings → Add-ons → Newt → Logs`).