Skip to main content

Activate your licence

Free works without a licence key, registration, activation or renewal request. Activate a paid licence only when you want the additional rights included in that licence. Your local Timon account remains separate from licence activation.

Activate from the command line

Run these commands against your own Timon installation:

timon license activate '<your-activation-key>'
timon license status

Replace the placeholder with the activation key supplied to you. Activation requires connectivity. Keep your key private: do not include it in shared scripts, screenshots or support logs. Command arguments may be retained in shell history; the Licence screen is an alternative to entering a key in a terminal.

The CLI reports whether activation succeeded and which edition is available. If activation is refused, check that you selected the intended installation and used the correct key. Follow the displayed message or contact support without sharing the key. See Command-line interface for targeting an instance.

Activation endpoint for custom clients

Use this endpoint on your own daemon, with an authenticated account allowed to manage that installation's licence:

POST /api/license/activate
Content-Type: application/json
{"key":"<your-activation-key>"}

On success, HTTP 200 returns the licence state; status is "valid", and plan and edition describe the activated offer. Clients should tolerate additional response fields. A failed request returns a non-success status and an error, sometimes accompanied by a message. Display a useful error without recording the submitted key. Missing authentication or insufficient rights must be resolved through normal sign-in; retrying does not grant permission.

This is a customer activation interface, not an interface for creating, issuing or administering other people's licences. Free needs no call to it. Prefer the supported CLI or Licence screen when you do not need a custom client.