Licensing

Energy SOAR requires two license files to start: one for the platform itself and one for the Energy Logserver back-end. Both files are validated during installation and on every service start.

License files

Two files are required for the Energy SOAR license:

  • energysoar_*.license — the signed license key.

  • energysoar_*.info — human-readable metadata: issue date, validity period, and end date.

Both files must share the same base name (the * part must match).

A separate pair of files is required for the Energy Logserver component:

  • es_*.* — placed at /usr/share/elasticsearch/license/ during installation.

Obtaining a license

Placing the license before installation

Before running install.sh, place both energysoar_* files in the same directory as the installer:

install_package/
├── install.sh
├── energysoar_*.license
└── energysoar_*.info

The installer validates both files before proceeding. If either file is missing, or if the license has expired, the installer exits with an error.

Placing the license on an installed system

On a running system, the license files live at /etc/energysoar/. This path is set in /etc/energysoar/application.conf.d/license.conf:

license.path: "/etc/energysoar/"

The service checks this directory and reloads the license automatically every five minutes. To apply a new license immediately, restart the service:

# systemctl restart energysoar

See Service control for the full service management reference.

License expiry

The installer reads expiry information from the .info file. It checks two conditions:

  • Issued on + Validity must be in the future, or

  • End date must be in the future (if set).

If both conditions fail, the installer exits with:

License validity expired

A warning is printed when less than 24 hours remain on either condition.

To check current license status on a running system, inspect the .info file directly:

# cat /etc/energysoar/energysoar_*.info

The file contains the Issued on, Validity, and End date fields in plain text.

Upgrading with a new license

When upgrading Energy SOAR, place the new license files in the package directory before running the upgrade. If you are also upgrading the Logserver component, provide both energysoar_* and es_* files.

See Upgrade for the full upgrade procedure.