Updated readme to include Proxy setup in home-assistant configuration.yaml
This commit is contained in:
parent
eab9375321
commit
8c904031a8
5 changed files with 250 additions and 0 deletions
49
README.md
49
README.md
|
@ -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`).
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue