Operations

FAQ

Short answers to the most common configuration decisions.

Should I mount the Docker socket in NasDash?

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.

Which Docker URL should I use?

The default command starts NasDash alone. For the optional local proxy, run the command below, then choose Address in Settings → Integrations → Docker. Enter docker-proxy in the host field and 2375 in the port field; the resulting endpoint is http://docker-proxy:2375. Keep the profile enabled on recreates and preserve the existing data mount.

docker compose --profile docker-proxy up -d

Where do I find the Tailscale "key" for the widget?

Create an OAuth client in the Tailscale admin console. The widget does not use an enrollment auth key. See Tailscale.

Can I use NasDash without a domain?

Yes, via http://SERVER_IP:2504 on the LAN or the Tailscale IP. A domain is mainly useful for HTTPS reverse proxy and access convenience.

Can I change the port?

Yes. Change the host port on the left, for example 8088:2504; keep the container port 2504.

Where are the data stored?

In /app/data, mounted from ./data by default. A named volume nasdash-data is an optional alternative.

Is Home Assistant supported?

Historical traces exist in some internal types, but the current device addition interface does not offer it. This documentation therefore does not present it as a supported user integration.

Where are the setup code and viewer password?

A new private installation prints one Setup code: XXXX-XXXX-XXXX in the container logs. It is the first password for admin; NASDASH_ADMIN_PASSWORD replaces it if set. There is no default viewer account or viewer password to retrieve. Choosing public mode creates viewer if missing, with a random password that is never printed. Anonymous access uses its permissions. Set a password in Settings → Users and access only if someone needs to sign in as that account. See first start and recovery.

What appears on a new Home page?

New installations have a clock and a weather widget, even if the guide is skipped, and no sample services, devices or Docker host. The guide’s widget step starts with the widgets already on Home; unticking one removes it when you continue.

On an empty page, administrators see a dashed Add a widget slot. Clicking it enters edit mode and opens the widget library. Other users see a single line of text indicating that there is nothing to show yet.

How do I replay the dashboard tour?

Open Settings → Help → Replay the tour. The tour also starts after finishing or skipping the first-start guide. Use Skip to leave before the final bubble, or Got it in the final bubble.