🏡 Home Assistant Newt Add-on

⚠️ Issue tracking is moved to discord

---

📌 About this Add-on

This Home Assistant add-on allows you to easily run Newt from Fossorial directly in Home Assistant. The add-on lets you configure PANGOLIN_ENDPOINT, NEWT_ID, and NEWT_SECRET via the Home Assistant interface.

🚀 Features

✅ Easy installation via Home Assistant Add-on Store
✅ Automated setup and execution of the Newt container
✅ Supports amd64, armv7, armhf, and aarch64 architectures
✅ Automatic restart on crash

---

🤝 Contributing

Want to help improve this project?
Check out CONTRIBUTING.md to get started. Issues can be postet on our community discord! Discord!

---

🛠️ Installation

1️⃣ Add the GitHub Repository as an Add-on Source

1. Go to Settings → Add-ons → Add-on Store.
2. Click the menu (three dots in the top right) and select Repositories.
3. Add the following URL:

   https://github.com/Ferdinand99/home-assistant-newt-addon
   

   or

   https://git.opland.net/Ferdinand99/home-assistant-newt-addon
   

4. Click Add and wait for the repository to load.

2️⃣ Install and Start the Add-on

1. Find Newt Add-on in the list and click Install.
2. Go to the Configuration tab and enter your values for:
   • PANGOLIN_ENDPOINT (e.g., https://example.com)
   • NEWT_ID
   • NEWT_SECRET
3. Click Save and then Start.
4. Check the Logs tab to verify that everything is running correctly.

---

⚙️ Configuration

After installation, you can configure the add-on via the Home Assistant UI:

PANGOLIN_ENDPOINT: "https://example.com"
NEWT_ID: "your_newt_id"
NEWT_SECRET: "your_newt_secret"

Docker Environment Variables

The following environment variables are passed to the Newt container:

• PANGOLIN_ENDPOINT
• NEWT_ID
• NEWT_SECRET

---

🛡️ 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:

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:

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:

ha core restart

---

🔍 Troubleshooting

💡 Add-on does not start?

• Check the logs in Home Assistant (Settings → Add-ons → Newt → Logs).
• Ensure that PANGOLIN_ENDPOINT, NEWT_ID, and NEWT_SECRET are set correctly.

💡 Changes in configuration do not take effect?

• Restart the add-on after making changes.
• Try removing the container manually:

  docker stop newt
  docker rm newt
  

  Then start the add-on again.

💡 Docker not available?

• Home Assistant OS manages Docker automatically, but check if the system has access to Docker by running:

  docker info
  

  If this fails, there may be a restriction in Home Assistant OS.

---

🔗 Useful Links

• 📖 Newt Documentation
• 🏡 Home Assistant
• 🐳 Docker Docs

---

© 2025 - Made with ❤️ for Home Assistant users 🚀