mirror of https://github.com/cassandra/home-information.git synced 2026-04-20 22:49:13 -04:00

Files

Anthony Cassandra f8ffdafaff Improve network access troubleshooting docs and sync unRAID config

Expand the troubleshooting section for HI_EXTRA_HOST_URLS — this was
the #1 stumbling block for unRAID users (Issue #238). The previous
one-liner didn't explain the required URL format or that this setting
is needed for any non-localhost access. Now includes format examples,
multiple URL syntax, and mentions the unRAID "Extra Host URLs" field.

Sync local unRAID XML template with the official community app repo
version (minor description update on HI_EXTRA_HOST_URLS field).

2026-03-29 13:24:56 -05:00

home-information.xml

Improve network access troubleshooting docs and sync unRAID config

2026-03-29 13:24:56 -05:00

README.md

Added unraid XML template and instructions.

2025-09-25 21:46:12 -05:00

README.md

Unraid Installation Guide

Home Information is available as a Community App for Unraid systems.

Quick Install (Recommended)

Install Community Applications Plugin (if not already installed):
- Go to Apps tab in Unraid
- Install "Community Applications" by squid
Search for Home Information:
- Apps tab → Search for "Home Information"
- Click "Install"
Configure Settings:
- IMPORTANT: Change the Django Secret Key to a random string
- IMPORTANT: Change the admin password from default
- Adjust port if 9411 conflicts with other services
- Review storage paths (defaults are fine for most users)
Access: http://YOUR-UNRAID-IP:9411

Manual Installation

If the app isn't in Community Apps yet, you can install manually:

Apps tab → Previous Apps → Add Container
Template URL: https://raw.githubusercontent.com/cassandra/home-information/master/unraid/home-information.xml
Click Add Container
Configure settings as above

Configuration Details

Required Settings

Django Secret Key: Generate a random 50-character string for security
Admin Password: Change from default for security

Storage Paths

Database: /mnt/user/appdata/home-information/database (SQLite database)
Media: /mnt/user/appdata/home-information/media (uploaded files)
Config: /mnt/user/appdata/home-information/env (optional environment files)

Network Settings

Port: 9411 (default, change if needed)
Network: Bridge mode (recommended)

Integrations

Home Assistant

If you're running Home Assistant on Unraid:

Note your Home Assistant URL (e.g., http://192.168.1.100:8123)
In Home Information, go to Settings → Integrations
Add Home Assistant integration with your URL and access token

ZoneMinder

If you're running ZoneMinder on Unraid:

Note your ZoneMinder URL (e.g., http://192.168.1.100:8080/zm)
In Home Information, go to Settings → Integrations
Add ZoneMinder integration with your URL and credentials

Troubleshooting

Container Won't Start

Check Unraid logs: docker logs home-information
Ensure storage paths are writable
Verify no port conflicts

Can't Access WebUI

Check container is running
Verify port mapping (default 9411)
Check firewall settings

Authentication Issues

Default: Authentication is disabled for local network use
To enable: Set HI_SUPPRESS_AUTHENTICATION to false

Security Notes

Local Network Only: By default, authentication is disabled for convenience on local networks
Change Defaults: Always change the Django secret key and admin password
Firewall: Don't expose port 9411 to the internet without proper authentication

Support

GitHub: https://github.com/cassandra/home-information/issues
Documentation: https://github.com/cassandra/home-information/tree/master/docs
Unraid Forum: Search for "Home Information" in Community Apps support