From 8c904031a8bb152766a61cb7d4b3940abb721f12 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B8rgen=20Ferdinand?= Date: Tue, 20 May 2025 22:23:52 +0200 Subject: [PATCH] Updated readme to include Proxy setup in home-assistant configuration.yaml --- .obsidian/app.json | 1 + .obsidian/appearance.json | 1 + .obsidian/core-plugins.json | 31 +++++++ .obsidian/workspace.json | 168 ++++++++++++++++++++++++++++++++++++ README.md | 49 +++++++++++ 5 files changed, 250 insertions(+) create mode 100644 .obsidian/app.json create mode 100644 .obsidian/appearance.json create mode 100644 .obsidian/core-plugins.json create mode 100644 .obsidian/workspace.json diff --git a/.obsidian/app.json b/.obsidian/app.json new file mode 100644 index 0000000..9e26dfe --- /dev/null +++ b/.obsidian/app.json @@ -0,0 +1 @@ +{} \ No newline at end of file diff --git a/.obsidian/appearance.json b/.obsidian/appearance.json new file mode 100644 index 0000000..9e26dfe --- /dev/null +++ b/.obsidian/appearance.json @@ -0,0 +1 @@ +{} \ No newline at end of file diff --git a/.obsidian/core-plugins.json b/.obsidian/core-plugins.json new file mode 100644 index 0000000..b977c25 --- /dev/null +++ b/.obsidian/core-plugins.json @@ -0,0 +1,31 @@ +{ + "file-explorer": true, + "global-search": true, + "switcher": true, + "graph": true, + "backlink": true, + "canvas": true, + "outgoing-link": true, + "tag-pane": true, + "properties": false, + "page-preview": true, + "daily-notes": true, + "templates": true, + "note-composer": true, + "command-palette": true, + "slash-command": false, + "editor-status": true, + "bookmarks": true, + "markdown-importer": false, + "zk-prefixer": false, + "random-note": false, + "outline": true, + "word-count": true, + "slides": false, + "audio-recorder": false, + "workspaces": false, + "file-recovery": true, + "publish": false, + "sync": true, + "webviewer": false +} \ No newline at end of file diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json new file mode 100644 index 0000000..c5602bb --- /dev/null +++ b/.obsidian/workspace.json @@ -0,0 +1,168 @@ +{ + "main": { + "id": "c7d9328c3c95b9b9", + "type": "split", + "children": [ + { + "id": "41f8e9f01b5e6fa9", + "type": "tabs", + "children": [ + { + "id": "adc04a3ea40602fc", + "type": "leaf", + "state": { + "type": "empty", + "state": {}, + "icon": "lucide-file", + "title": "New tab" + } + } + ] + } + ], + "direction": "vertical" + }, + "left": { + "id": "c7525516e8b34005", + "type": "split", + "children": [ + { + "id": "8779d100ba82b6a7", + "type": "tabs", + "children": [ + { + "id": "35f93034ddfdc97b", + "type": "leaf", + "state": { + "type": "file-explorer", + "state": { + "sortOrder": "alphabetical", + "autoReveal": false + }, + "icon": "lucide-folder-closed", + "title": "Files" + } + }, + { + "id": "4c3a13d1c0ba2006", + "type": "leaf", + "state": { + "type": "search", + "state": { + "query": "", + "matchingCase": false, + "explainSearch": false, + "collapseAll": false, + "extraContext": false, + "sortOrder": "alphabetical" + }, + "icon": "lucide-search", + "title": "Search" + } + }, + { + "id": "9c91d73c657efd5e", + "type": "leaf", + "state": { + "type": "bookmarks", + "state": {}, + "icon": "lucide-bookmark", + "title": "Bookmarks" + } + } + ] + } + ], + "direction": "horizontal", + "width": 300 + }, + "right": { + "id": "3905c5a180e16de7", + "type": "split", + "children": [ + { + "id": "d79146b109d8856d", + "type": "tabs", + "children": [ + { + "id": "d00f53a24cc245b7", + "type": "leaf", + "state": { + "type": "backlink", + "state": { + "collapseAll": false, + "extraContext": false, + "sortOrder": "alphabetical", + "showSearch": false, + "searchQuery": "", + "backlinkCollapsed": false, + "unlinkedCollapsed": true + }, + "icon": "links-coming-in", + "title": "Backlinks" + } + }, + { + "id": "cd90b4889caa9f51", + "type": "leaf", + "state": { + "type": "outgoing-link", + "state": { + "linksCollapsed": false, + "unlinkedCollapsed": true + }, + "icon": "links-going-out", + "title": "Outgoing links" + } + }, + { + "id": "4d563aa5038f1630", + "type": "leaf", + "state": { + "type": "tag", + "state": { + "sortOrder": "frequency", + "useHierarchy": true, + "showSearch": false, + "searchQuery": "" + }, + "icon": "lucide-tags", + "title": "Tags" + } + }, + { + "id": "b03883ef80f1147d", + "type": "leaf", + "state": { + "type": "outline", + "state": { + "followCursor": false, + "showSearch": false, + "searchQuery": "" + }, + "icon": "lucide-list", + "title": "Outline" + } + } + ] + } + ], + "direction": "horizontal", + "width": 300, + "collapsed": true + }, + "left-ribbon": { + "hiddenItems": { + "switcher:Open quick switcher": false, + "graph:Open graph view": false, + "canvas:Create new canvas": false, + "daily-notes:Open today's daily note": false, + "templates:Insert template": false, + "command-palette:Open command palette": false + } + }, + "active": "adc04a3ea40602fc", + "lastOpenFiles": [ + "README.md" + ] +} \ No newline at end of file diff --git a/README.md b/README.md index d02ee86..ab8722d 100644 --- a/README.md +++ b/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`).