Skip to main content

Activate a workstation against your server

Use this guide to configure AITrax against a self-hosted server. You'll run setup with your server's base URL and confirm the result.

  • Deployment: On-premises

On-premises setup uses a base URL rather than an install token. No token redemption occurs. Network reachability to the server's base URL is the practical control on which workstations can activate. If activation must be limited to specific machines, restrict network reachability to the hostname — rolling out setup through the Fleet distribution device-management pattern controls which machines receive the installer, but not which machines can reach the server, so it doesn't substitute for that restriction. Captured activity is attributed by the workstation's existing Git committer identity (the user.name and user.email already in its commits) — no login or credential is involved. See What is captured.

Fleet distribution

Rolling this out across many machines? Workstation setup can be distributed through your existing device-management software so each machine is configured without anyone opening a terminal — see Onboard a developer for the fleet pattern and example tooling. Contact your CodeTogether representative for help packaging the rollout for your tooling.

Before you begin​

You need all of the following:

  • Your server base URL: Ask your administrator for the URL your organization uses to reach the platform. This is the service hostname configured at deployment (for example, https://ctai.yourcompany.com) — the same URL developers use to reach the portal. A separate download host applies only if your deployment serves artifacts from a different host; see Troubleshooting.
  • Network access to that URL from your workstation: Setup downloads the tracker binary and reports completion over it.

1. Run setup with your base URL​

aitrax setup system --url <server-base-url>

Replace <server-base-url> with your organization's base URL.

2. Confirm setup completed​

aitrax setup check

If system reports as configured, the workstation is connected.

Terminal
$ aitrax setup check
{
  "system": {
    "configured": true,
    "missing": [],
    "loginCleanup": {
      "state": "clean"
    }
  }
}

Troubleshooting​

The tracker binary cannot be downloaded​

Setup downloads artifacts over the base URL unless a separate download URL is configured. If your deployment serves artifacts from a different host, set AITRAX_DOWNLOAD_BASE_URL, which overrides artifact downloads only.

Setup completes but the server records nothing​

Setup reports completion to the server after activation unless reporting is disabled. Confirm --no-report-setup was not passed.

If this doesn't fix it​

Contact support with all of the following:

  • The verbatim command you ran and its complete output.
  • The base URL you passed, with any credentials removed.
  • The output of aitrax setup check and aitrax doctor.
  • Your server version and aitrax version.