Troubleshooting

Diagnose common Goauld deployment and connection problems

Start with Diagnose an agent, then use the relevant component guide:

The agent does not appear
Control works, but SSH fails
The agent repeatedly reconnects
Server healthchecks
Connection flow
Access control
Client authentication
Transport configuration
Persistent sessions

When reporting a problem, include the Goauld version, operating system, selected transport, the exact command, and the relevant server and agent log lines. Remove tokens, private keys, hostnames, and addresses before sharing logs.

Diagnose an agent

A practical checklist for investigating an agent connection

The agent does not appear

Troubleshoot an agent that does not register with the server

Control works, but SSH fails

Troubleshoot SSH sessions after an agent has registered

The agent repeatedly reconnects

Investigate unstable agent transports