A lightweight Home Assistant add-on that keeps a Dreamhost DNS A and DNS AAAA record updated with your current WAN IP.
Perfect for:
- Remote access to Home Assistant
- Dynamic IP home internet users
- Self-hosted services with changing IPs
- Anyone who uses DreamHost for DNS hosting
- Automatically updates the DreamHost A record when your IP changes
- Safe update sequence avoids DNS outages
- Choose update interval from within the add-on UI
- Logging with adjustable verbosity
- Designed specifically for Home Assistant environments
- Works standalone or within Home Assistant
- In Home Assistant, go to Settings → Apps → Install App
- Click the ⋮ menu → Repositories
- Add this URL: https://github.com/PRProd/home-assistant-addon-dreamhost-ddns
- Click Add
- Install DreamHost DDNS
- Configure and start the add-on
Make sure you are on a Supervisor-managed system that supports add-ons.
| Setting | Description | Type |
|---|---|---|
api_key |
Your DreamHost API key (with DNS permissions) | password |
dns_record |
DNS A record to update (e.g., ha.example.com) |
string |
| Setting | Description | Type | Default |
|---|---|---|---|
interval |
Seconds between checks (default 300 = 5 minutes) | int | 300 |
log_level |
Log verbosity (trace, debug, info, warn, error) | enum | info |
api_key: "YOUR_DREAMHOST_API_KEY"
dns_record: "ha.example.com"
interval: 300
log_level: info- Detects your current public WAN IP using multiple online services
- Fetches the current DNS A record from DreamHost
- If the IP has changed:
- Adds the new DNS record
- Verifies the update
- Removes the old DNS record only after the new one is verified
This sequence prevents temporary DNS outages during updates.
Logs are accessible from the add-on UI. Use the log_level setting to control verbosity:
| Level | Output Shows |
|---|---|
| error | Only errors |
| warn | Errors + warnings |
| info | Normal operations (default) |
| debug | Detailed debug info |
| trace | Most verbose, very detailed |
- Click Start to begin periodic updates
- Use Stop to halt updates
- Restart applies any updated configuration
- Ensure your DreamHost API key has DNS permissions
- For frequent IP changes, lower interval values (e.g., 120s) may help
- Test your configuration with the add-on logs before leaving it running
If Home Assistant reports "failed to start", check:
- API key and record are correct
- Network connectivity
- Firewall or proxy is not blocking outgoing HTTP calls
dreamhost-ddns Rust CLI - the standalone binary used by this add-on
- Open an Issue on GitHub
- Star the repository ⭐ to show support
- Share feedback in the Home Assistant community forum