Service Troubleshooting

A service is not receiving connections

1. Verify the service is configured in trapster.conf and Trapster is running
2. Check the port is actually listening: ss -tlnp | grep <port>
3. Test connectivity from another host: nc -zv <trapster-ip> <port>
4. Check your firewall - the port must be reachable from the network segments you want to monitor

Credentials are not being captured

Some services require a specific client interaction before credentials are exchanged. Ensure:

• The client is actually sending credentials (not just scanning)
• The service version string in your config matches what the client expects (e.g. MySQL auth plugin compatibility)

HTTP skin not loading

• Verify the skin folder name matches a directory in trapster/data/http/
• Check that config.yaml inside the skin folder is valid YAML
• Check Trapster logs for template rendering errors

Enterprise: service shows as offline in dashboard

1. Check that the Trapster is reachable and the sync is active (see Installation Troubleshooting)
2. Try reapplying the configuration template from Trapsters → device → Services
3. Reboot the Trapster if the service does not recover