Agents > Agent > Docs > Licensing

Licensing

The license dialog shows which license you have and how long it lasts, and lets you update the license key. There is no built-in trial key in the product: keys are issued manually, and without one everything works except a single action — sending a message to the agent chat. Open the dialog by clicking the license line at the bottom of the settings window.

License dialog showing the current license status

License information

The dialog shows the following details about your license:

  • Licensed to — the name, company, or domain the license is issued to
  • License type — Trial, Personal, Company, or Service
  • License scope — what the license covers (see License types below)
  • Email — the license contact address
  • Valid from — the start date
  • Valid until — the end date, or “Perpetual” when there is no expiry
  • Status — “Valid” (shown in green) or an error message (shown in red)

License types

  • Trial — getting to know the product for a limited time: it shows how many days are left. The trial key is never created on its own and is issued manually — as part of the Trial tier.
  • Personal — for a single developer or a single-person company. The license is tied to one user.
  • Company — a license for the whole company: it covers all of the company’s developers. Any developer of the company can use Xedant Agent under this license.
  • Service — a license for a whole domain: it covers everyone who signs in to Xedant Agent from the licensed domain. Handy for teams working on a shared server.

Any license can be perpetual (with no end date) or time-limited. Perpetual licenses show “Perpetual” as the end date and never expire.

The license info line

The license state is visible in the settings window: a quiet line, centered, at the very bottom, below all the cards. The status panel and the build and deployment panels no longer carry it — the license stays out of the way and reminds of itself only where you look for it. The text depends on the status:

  • No license — “No license file found”
  • Invalid — “Invalid license format”
  • Expired trial — “30-day free trial has expired, please upgrade”
  • Expired — “{License type} (Expired)”
  • Trial — “Free trial, X days left”
  • Valid — “Licensed to {Name}” or “{Type} (X days remaining)”

Click the line to open the license dialog. The line cannot be hidden: the “×” button on the line itself and the “Show Licensing Info” switch in Settings are gone — it is always visible. With a trial or a missing license, a “Renew” or “Get license” link remains next to the line.

Updating your license

To update or activate your license:

  1. The license key is issued manually: the trial one — as part of the Trial tier, the paid one — together with the Agent Factory subscription
  2. Open the license dialog (click the license line, or use the menu)
  3. Paste the key into the field in the “Update License” section
  4. Click “Update License”

The system verifies the new license, saves it to .xedant/license.txt, and refreshes the status. Every connected device learns about the update over SignalR by itself — there is no need to reload the page.

Where licenses are stored

Xedant Agent looks for the license key in three places, in this order of priority:

  1. .xedant/license.txt — a file in your project folder (highest priority). This is where the “Update License” button writes to. You can keep it in Git if the key is not secret.
  2. The --license argument — passed when the application starts (for example, ./XedantAgent --license /path/to/key)
  3. The AGENT_LICENSE environment variable — set in the system settings or in the Docker configuration

The value can be the key itself or a path to a file: if the given path exists, Xedant Agent reads the key from that file.

Troubleshooting

  • “Invalid license format” — check that you pasted the complete key. Keys are base64-encoded and start with eyJsaWNlbnNlVmVyc2lvbiI6IjEuMCI.... Copy the whole key, with no extra spaces or line breaks.
  • “No license file found” — place the key in .xedant/license.txt, pass it with the --license argument, or set the AGENT_LICENSE environment variable.
  • “Expired” — the license has passed its end date. For a new or renewed license, see the Agent Factory page.
  • The update does not take effect — after you click “Update License”, the dialog should refresh on its own. If it does not, reload the page. The change reaches every connected device over SignalR within a couple of seconds.
  • The license works locally but not in Docker — make sure the container can see the license file: mount .xedant/license.txt as a volume, or pass the key through the AGENT_LICENSE environment variable in the Docker configuration.

← Commits

Analytics →