Licensing from the command line¶

Use und to license headless / CI machines. Run und help licensing for the built-in reference.

See current license info¶

und license                 # prints current license info + enabled options
und license -enabledoptionsoff   # omit the enabled-options list

und license is read-only and never checks out a seat — safe to run on a saturated floating code or an air-gapped machine. Full details: und license reference.

Configure a license (top-level und switches)¶

These are top-level und switches (not sub-commands) — the complete list is in the und licensing reference:

und -setlicensecode <CODE>          # set the license code
und -setlicenseserver <HOST>        # point at a license server (e.g. licensing.scitools.com)
und -refreshlicense                 # refresh from the server
und -deregisterlicensecode          # release / deregister this machine's code

Check license state (good for CI gates)¶

und -isundlicensed          # prints 1 (licensed) or 0 (not); exits with code 2 when unlicensed
und -licensehowmanydays     # days remaining

-isundlicensed contacts the server (when floating)

With a floating license this is a live validation, not a local check — it briefly checks a seat out against the license server and releases it again. With a valid offline or node-locked code the check is purely local and never touches the network. In scripts, prefer testing the exit code (0 licensed, 2 not). For a local-only alternative in any mode, run und license — it reports the current license without ever checking out a seat.

Offline codes¶

und -enterofflinemode
und -createofflinerequestcode        # (-showofflinerequestcode / -newofflinerequestcode)
und -setofflinereplycode <CODE> -expiration <yyyyMMdd>   # add -maintenance <yyyyMMdd> for perpetual licenses
und -showofflinereturncode           # when returning
und -enteronlinemode

Node-lock codes¶

und -createnodelockrequestcode       # (-shownodelockrequestcode)
und -setnodelockreplycode <CODE>
und -shownodelockreturncode

Environment-variable overrides¶

Env vars take precedence over stored settings — handy for CI runners and shared machines:

Variable	Effect
`UNDERSTAND_LICENSE_CODE`	Use this license code
`UNDERSTAND_LICENSE_SERVER`	Use this license server (highest precedence)
`STI_LICENSE_SERVER`	Legacy server override (fallback if `UNDERSTAND_LICENSE_SERVER` unset)
`UNDERSTAND_LICENSE_ALLOW_HTTP`	Allow plain HTTP to the license server (suppresses the HTTPS warning)