Integrations
Choose, connect, and troubleshoot each supported external source.
Infrastructure integrations are queried by the NasDash server; the Weather widget calls Open-Meteo from the browser. Store reusable monitoring, Docker, Tailscale/Headscale, Pi-hole and AdGuard Home connections in Settings → Integrations, then select them from machines or widgets. Browser reachability alone does not prove container reachability.
Docker management is optional. Choose Portainer, Dockhand, an HTTP(S) Docker-compatible API, or a Unix socket. The local socket proxy is one option; Portainer and Dockhand do not require it. See Docker connections.
| Need | Guide | Required Secret |
|---|---|---|
| Existing Portainer | Docker connections | Dedicated API key + environment ID |
| Existing Dockhand | Docker connections | Dedicated API token + environment ID |
| Local Docker | Proxy in the same Compose | No |
| Docker on another machine | Remote Docker Proxy | Depends on transport |
| Tailnet status | Tailscale Widget | OAuth Client ID + secret |
| VPN tunnel | Gluetun (VPN) | API key for a reading role |
| Linux / macOS / generic host | Glances | Optional Basic |
| Hypervisor | Proxmox VE | API token |
| Windows | Libre Hardware Monitor | No |
| Events | ICS Calendar | Possible private URL |
| Forecasts | Weather | No key |
| Ad blocking | Pi-hole, AdGuard Home and Technitium | App password, account or API token |
| UPS | UPS (NUT, apcupsd) | Server address (no account) |
| File sync | Syncthing | API key |
| Internet speed | Speedtest Tracker | API token |
| Container updates | What's Up Docker | Optional user and password |
| Notes, to-do, countdown, web page | Notes and tools | No |
| Uptime | Uptime Kuma | No (a public status page) |
| Media requests | Seerr | API key |
| Notifications | ntfy and Gotify | Optional token, or client token |
| Reading | Audiobookshelf, Kavita and Komga | API token or key |
| News | News feeds | No (feed address may be private) |
| Prices | Markets | No key |
| Quotes | Quotes | No key |
| Photos | Immich and PhotoPrism | Read-only API key or app password |
| Bookmarks | Bookmarks | No key |
| Media | Jellyfin, Emby and Plex | API key or Plex token |
| *arr and downloads | *arr and download clients | API key or client account |
| Music | Music | Media server or Navidrome account |
| Custom API | Custom API | Optional token, header, user or parameter |
Address as seen from NasDash
Within the same Compose, use the Docker service name. Across two hosts, use a routable private IP, an internal DNS name, or a Tailscale IP. localhost refers to the NasDash container itself.
The monitoring source reference covers all six sources; dedicated guides also cover Netdata, Beszel and Prometheus/node_exporter. Docker supports Unix sockets, Portainer, Dockhand and Docker-compatible Podman APIs; see Docker connections. All Tailscale widgets use the Tailscale or Headscale connection saved last. Headscale requires its server URL and API key; widgets have no individual connection selector.