Skip to main content

No tracker binary available

Message​

This message appears when AITrax cannot find or obtain the native tracker binary it needs to run.

No tracker binary available

Why you're seeing this message​

  • The download was blocked by a proxy, firewall, or TLS interception.
  • The download base URL is wrong or unreachable from this machine.
  • A path override points at a location that has no binary.
  • The binary was removed after setup, for example by disk cleanup or endpoint security software.

What to do​

  1. Confirm the machine can reach the download host — your deployment's base URL, unless AITRAX_DOWNLOAD_BASE_URL overrides it (step 3). If it cannot, the cause is network policy rather than AITrax, and no local change will fix it.
  2. Check whether a path override is set. AITRAX_BIN and AITRAX_TRACKER_DIR redirect where AITrax looks. Clear them to fall back to the managed location, then re-run the command that reported the message.
  3. If your deployment serves artifacts from a different host than the platform itself, confirm AITRAX_DOWNLOAD_BASE_URL is set correctly. It overrides artifact downloads only.
  4. Re-run setup for your deployment. See Set up your workstation.

If this doesn't fix it​

Contact support with all of the following:

  • The verbatim message text and the command that produced it.
  • The output of aitrax doctor.
  • Your operating system and processor architecture.
  • Any AITRAX_ environment variables set on the machine, with secrets removed.
  • Your audit log from ~/.codetogether/aitrax.jsonl, which records download failures.