Documentation

Activate your StackRegent license

Three ways to enter an SR- license key, what happens when you do, and how to read the License Information page afterwards.

Step by step 2 min read Updated

Before you start#

A StackRegent license key looks like SR-XXXXX-XXXXX-XXXXX-XXXXX. You find it in the welcome email and on the license's service page in the client area. One key licenses one server: at its first successful check, the key is bound to that server's Windows machine ID. Trial keys from the free trial work the same way, for 10 days and 3 subscriptions.

The server needs outbound HTTPS to panel.stackregent.com and a correct clock. Keys bought earlier at system.coreinto.com keep working; the panel asks the server that knows its key.

Step 1: Choose how to enter the key#

Pick the one that suits you:

  • With the installer. Pass -LicenseKey SR-... to the one-line installer or to install.ps1. The installer checks it once the panel runs and masks it in the install log.
  • In the panel. Go to Tools & Settings › License Information, click Enter key (or Change key when one is saved), type it in Licence key and click Save and check.
  • On the command line. In an elevated PowerShell, run & "C:\Program Files\StackRegent\bin\stackregent.exe" license-set SR-XXXXX-XXXXX-XXXXX-XXXXX. To keep the key out of command history and logs, set the environment variable STACKREGENT_LICENSE_KEY and run license-set without an argument.

Step 2: Let the panel check it#

The panel asks the license server at once. A new key is saved only when the license server accepts it. If the panel already has a working license, a key that cannot be checked leaves the current one in place, so a typo never takes a working server down.

Step 3: Read the License Information page#

Tools & Settings › License Information shows:

FieldWhat it tells you
StateLicensed, Grace period or Restricted, with the license server's message
EditionYour plan; trial licenses carry a Trial badge
SubscriptionsSubscriptions in use and the limit of your plan
Valid until / Works untilWhen the current check expires, or when the grace period ends
Next payment dueThe service's next due date
Last successful check and Last problemWhen the license server last answered, and the last error

Click Check now at any time, for example after a renewal. From the command line, stackregent license-check does the same and prints the state.

After activation#

The panel checks the license every 24 hours at a random minute. If the license server cannot be reached, it retries after an hour and then every 6 hours, and keeps working through the grace period meanwhile. Every plan includes every feature; the plans differ only in how many subscriptions they allow. When you reach the limit, new subscriptions are refused with a message naming it, and existing ones are never touched; see renew or upgrade your license.

If the state reads Restricted, see license restricted mode. The licensing chapter of the administrator guide has the full reference. Anyone can check whether a server is licensed at stackregent.com/verify-licence.

Frequently asked questions

Where do I find my StackRegent license key?

In the welcome email sent after your order, and on the license's service page in the client area at panel.stackregent.com.

Can I use one StackRegent license on two servers?

No. A license key is bound to one server's Windows machine ID at its first check. Each server needs its own license; a license can be moved to a new server by reissuing it.

Does StackRegent need internet access for the license?

The panel checks the license once a day over HTTPS. Short outages do no harm: the panel keeps working until the check expires and then through a grace period, with a banner showing the date.

Was this article helpful?

Something missing? Ask in the community or open a ticket.