The agent does not appear

Troubleshoot an agent that does not register with the server

An agent must complete its outbound control connection and registration before it appears in tealc list or the TUI.

Check these in order:

  1. Confirm that the process is running on the target machine.
  2. Confirm that the target resolves the configured server hostname.
  3. Test the configured egress port from the target machine.
  4. Confirm that the agent’s public age key matches the server’s private key.
  5. Confirm the server address, port, and access token in the agent build configuration.
  6. Read the agent log for the selected transport and registration error.
  7. Read the server log for a rejected connection or authentication failure.

On the operator workstation, verify that the client is using the same server and access token:

tealc list
tealc --verbose list

Expected output when the agent is registered:

TODO_PLACEHOLDER_HERE

If the agent connects and disappears, continue with reconnect troubleshooting.