Install License Key

How to install a license key.

This page is applicable for the latest image version mcx-rtos-v.2025.03. For other mcx-rtos-images checkout: Older versions.

Motorcortex Libraries require a license.lic ([hardwarekey].lic) file to run in a production environment. This section will explain how to acquire and install license.lic file. You can always run your Motorcortex application without a license key, but the program will exit after 30 minutes.

Acquire The License File.

For generating a license file the controller Hardware key is needed.

  1. Acquire the hardware key.

  2. E-mail this hardware key and list of components to license@vectioneer.com

  3. You wil receive a 123456789.lic file trough E-mail, where the filename corresponds to the Hardware Key.

Installing the license file on the controller.

The license file can be stored in any location on the controller and can have any filename, as long as the “license” tag in the config.json file points to this file.

You can therefore add the license file into the configuration package so you can deploy it through the portal. The drawback is that for every controller hardware, you need to have a separate configuration package. The solution is to install the license in a differnt location than the configuration folder, so it does not get overwritten if you deploy the configuration and the license file stays with the machine.

Preferred method: install the license file in /etc/motorcortex via Cockpit

The license file can be stored in a location that is not affected by deploying a configuration. The license now stays with the controller regardless of the configuration that is deployed. A convenient location for the license is /etc/motorcortex/, this file directory is not overwritten when deploying a new configuration.

  1. Inside config.json change license path to: "License": "/etc/motorcortex/license.lic".

  2. Log in to Cockpit.

  3. Browse to Navigator Tab, navigate to /etc/motorcortex/ folder and Upload the 123456789.lic.

    image not found
  4. Inside the /etc/motorcortex/ folder, create New Symbolic Link. Target: 123456789.lic Name: license.lic.

    image not found
  5. Restart your Motorcortex Application.

Check If The License File Is Valid

A license file is valid if it matches the controllers Hardware Key and application: List of Components. The status of the license can be seen in the log of the motorcortex application:

Browse to Cockpit terminal and execute the following command:

mcx-lastlog | grep License

If your license check turns out invalid: check if your Hardware Key, List Of Components match your hardware device and application.

Older Versions