Troubleshooting and uninstalling

General troubleshooting

• Run nia-agent status first — it reports how long the agent has been running, whether it's paired, when it last checked in, and the health of each job.
• A database connection failure is almost always a network, host/port, or credentials problem — confirm with nia-agent connection test <short-id>.
• If a job won't run, check its error class on the Agents page or in nia-agent status — see Monitoring and control for what each one means and what to do.
• If the agent isn't showing up on the Agents page at all, confirm it has outbound HTTPS access to the Nia Core platform address — no inbound ports are ever needed.
• A published job rejected with "destination not on local allow-list" needs nia-agent destinations allow <hostname> run on the agent machine.

Uninstall on Windows

Use Settings → Apps → Nia Core Agent → Uninstall — it asks whether to keep or delete the agent's stored configuration.

Uninstall on macOS

./uninstall.sh

Add --purge to also remove stored configuration and logs.

Uninstall on Linux

sudo ./uninstall.sh

Add --purge to also remove stored configuration.