Troubleshooting

Troubleshooting

A host doesn't appear on the dashboard

• Check the agent is running: systemctl status autormm-agent (headless) or systemctl --user status autormm-agent (desktop).
• Check its logs: journalctl -u autormm-agent -f.
• Verify it can reach the hub: curl http://<hub-ip>:8765/healthz from the host.
• Confirm the enroll token matches the hub's.
• Firewall: the host must be able to reach the hub on its port (default 8765).

No graphs in the host detail view

Time-series graphs need the history database. It's on by default; if you started the hub with a custom setup, ensure --db <path> is set and writable. Sparklines and current values work without it — only the historical charts need it.

The "Remote" button is greyed out

That host has no graphical session to stream (it's headless, or the agent was installed as a system service instead of the &desktop=1 desktop variant). Screen sharing needs a desktop agent. Terminal, metrics, exec, and scripts still work.

Remote desktop is black / doesn't update

• Linux screen capture is X11-only — use Xorg or Xwayland, not native Wayland.
• The agent needs access to the X session (DISPLAY / XAUTHORITY); the desktop installer sets this up. Running the agent as a system service (no session) won't capture the screen.

Windows agent install fails (Access is denied / parameter is incorrect)

The Windows install registers a logon scheduled task that runs with highest privileges, so it must be run from an elevated PowerShell — Start → right-click Windows PowerShell → Run as administrator, then paste the Add-host command again. Access is denied (0x80070005) means the window wasn't elevated. (Older builds also failed with The parameter is incorrect (0x80070057) on a bare username — fixed in v0.4.1; update the hub if you still see it.)

Just want to test quickly without installing the task? Run the agent in the foreground instead:

& "$env:LOCALAPPDATA\autormm\autormm-agent.exe" -server http://<hub-ip>:8765 -token <enroll>

No H.264 toggle in the remote viewer

The JPEG-tile / H.264 toggle only appears when both ends can do H.264:

• the host has ffmpeg (with libx264) on its PATH — install it, then restart the agent so it re-registers its capabilities;
• your browser supports WebCodecs — use Chrome or Edge.

If it's still JPEG-only, that's expected and harmless — JPEG-tile is the default and works everywhere. (If you pick H.264 and it can't decode, the viewer falls back to JPEG automatically.)

Terminal doesn't work on a Windows host

The Windows agent terminal isn't available yet (it needs ConPTY). Use the browser/CLI terminal on Linux/macOS hosts; on Windows, use exec for one-off commands.

Can't reach the dashboard from another machine

• Confirm the hub is bound to a reachable address (-addr 0.0.0.0:8765, not 127.0.0.1).
• From outside your LAN, you need a zero-trust overlay or VPN — see Remote Access. Don't port-forward it to the internet.

Resetting the admin token

Stop the hub, edit ~/.config/autormm/autormm.json (or the env file), and restart. Agents keep working as long as the enroll token is unchanged.