Client Versioning Information
Last modified on October 18, 2023
This page provides general information about StrongDM client versioning, including what happens if a user’s client version is below the minimum supported or required version.
Version Numbering
StrongDM increments versions as follows:
- n.0-100.0 for each release (such as
32.97.0
,32.98.0
,32.99.0
,33.0.0
) - a.b.1 for patch releases (such as
32.97.1
) - Releases that are not mentioned in the Release Notes are internal and therefore not described. If looking at a list of releases from a particular software, this might result in the appearance of numbers missing from the sequence, such as
32.97.0
,32.98.0
,33.2.0
,33.3.0
.
How to View Version Numbers
In the CLI, users may view the current version by running sdm --version
, as in the following example:
$ sdm --version
sdm version 39.79.0 (8051323ec790f342a12d738a59f624d25df9d90f #2180)
In the desktop app, the current client (CLI) version and app version are shown in the Account menu underneath your name (for example, “Client 39.79.0 / App: 21.33.0”).
Minimum Supported Version
The minimum supported version of the StrongDM client is version 33.17.0.
If below the minimum supported version, the client still functions but uses a deprecated authentication mechanism with a weak security profile. In addition, due to the use of the deprecated authentication mechanism, the client may fail to form linking or peering connections with other gateways at versions above version 33.17.0.
A warning displays in the desktop app and/or CLI if your client version is below the minimum supported version.
CLI warning message
Warning: client software version <VERSION> is beneath the minimum supported version 33.17.0
Call 'sdm update' or redownload the software to address this. Some functionality may fail while not up to date
Desktop app warning message
“Client software version
Minimum Required Version
The minimum required version is the version, if any, that your organization’s administrator(s) specify as the minimum required version for use. The default value is “no minimum.”
Errors
If the client version is below the minimum required version, all non-essential operations are explicitly blocked until the client is updated, and an error message is displayed in the CLI or desktop app.
CLI error message
Your SDM version <VERSION> is beneath your team's minimum required version: <REQUIRED_VERSION>. Please update to proceed.
Desktop app error message
“Client software version
Recommended resolution
If the CLI is beneath the minimum supported required version, we recommend that you run the sdm update CLI command. Then check the version by running sdm --version
.
If the desktop app is below the minimum required version, follow the instructions given in the desktop app’s update required message. Then check the client version in the desktop app’s Account menu.
If the update fails, redownload and install the appropriate StrongDM package for your operating system.