Skip to main content

Agent Issues

Troubleshooting the Tergum agent.

Agent Won't Start​

Check logs:

journalctl -u tergum-agent -n 100

Common issues:

  • Config file missing: Check /opt/tergum/config/agent.conf
  • Invalid token: Verify API_TOKEN in config
  • Python error: Check Python 3 is installed

Agent Running But Not Reporting​

Verify connectivity:

curl -I https://app.tergum.ca/api/health

Check config:

cat /opt/tergum/config/agent.conf

Ensure API_ENDPOINT is correct.

Agent Version Mismatch​

Check current version:

grep VERSION /opt/tergum/agent/tergum_agent.py

Update agent: Use the Admin panel in dashboard, or manually:

curl -o /opt/tergum/agent/tergum_agent.py \
  https://app.tergum.ca/api/agent/tergum_agent.py
systemctl restart tergum-agent