What this widget is for
Displays connection and storage-server status for TrueNAS.
It belongs to HomeStart’s Homelab & network collection and can be placed on any suitable dashboard page.
Add and set it up
- Open the dashboard page where you want the widget.
- Choose Add widget and search for the widget name.
- Add it, then resize it so its main information is readable.
- Open Configure and provide a reachable truenas api url and read-only credential.
- Use Test when available, then save only after the connection succeeds.
- Refresh once and confirm the widget keeps its settings.
Connection required
A reachable TrueNAS API URL and read-only credential.
Connection secrets are submitted to the HomeStart server and stored encrypted. Use a dedicated read-only credential whenever the provider supports one.
Everyday controls
The widget header provides its title and dashboard controls. Depending on the widget, these can include refresh, full-screen, hide-controls and hide-title buttons. Content-specific controls remain inside the widget.
Use Customize layout to move or resize the widget. Leave layout mode when finished so normal buttons and scrolling work as intended.
Useful advice
Good to know
- Prefer private LAN or VPN addresses and read-only credentials.
- Test the connection before saving it.
- Never expose an administrator panel, exporter or Docker socket publicly just to make a widget connect.
If it does not work
- Refresh the individual widget first.
- Confirm its settings are complete and still saved.
- For connected data, test the provider or private address from HomeStart.
- Temporarily make the widget larger to reveal clipped controls or messages.
- Record the widget name and exact error before contacting support; never include a password, recovery code or API token.