Managing SolidCraft in an organization
An administrator can set some SolidCraft settings for everyone who uses a computer, with Group Policy or Microsoft Intune. A setting under policy shows in Preferences as Set by your organization, and people cannot change it. While any policy is set, SolidCraft says it is Managed by the organization. This works on Windows today.
A computer without a policy behaves exactly as before. SolidCraft only reads the policy: it writes nothing, and it sends nothing about the policy anywhere.
Install
The Windows installer (solidcraft-windows-x64.msi, also arm64 and x86) installs for all users.
msiexec /i solidcraft-windows-x64.msi /qn installs it without questions, so a deployment tool
can run it.
The policies
| Policy | Registry value | Type | Values |
|---|---|---|---|
| Check for updates | CheckForUpdates | REG_DWORD | 1: checks at start and once a day, and people cannot turn them off. 0: no checks at all, as with SOLIDCRAFT_UPDATE_CHECK=0 (Updates and privacy). |
| Organization name | OrganizationName | REG_SZ | The name shown as Managed by and the name, up to 64 characters on one line. It changes no setting. |
The values live in the key Software\Policies\SolidCraft:
- under
HKEY_LOCAL_MACHINEfor everyone on the computer, or - under
HKEY_CURRENT_USERfor one person.
When both hold a value, the computer’s value wins. A value of another type, a number other than the ones listed, or an empty name counts as not set.
SolidCraft reads the policy when it starts. A change applies the next time SolidCraft starts. When a policy is removed, the person’s own earlier choice is back.
The same value names under Software\Policies\SolidCraft\Recommended are reserved for defaults
that people may change. SolidCraft reads them and does not apply them yet.
The templates
Each release has solidcraft-<version>-windows-policy-templates.zip, listed in
SHA256SUMS.txt. It holds the administrative template, solidcraft.admx, and its English text,
en-US/solidcraft.adml (they are also in packaging/windows/policies/ in the source). Take the
zip from the release you deploy: it holds the policies that version reads. The policies appear in
the SolidCraft folder.
Group Policy. Copy solidcraft.admx into PolicyDefinitions and solidcraft.adml into
PolicyDefinitions\en-US, on one computer (%SystemRoot%\PolicyDefinitions) or in the domain’s
central store. The policies are under both Computer Configuration and User Configuration,
Administrative Templates, SolidCraft.
Intune. In the Intune admin center choose Devices, Manage devices, Configuration, the Import ADMX tab, Import, and upload the two files. Then choose Create, New policy, the platform Windows 10 and later and the profile type Templates, Imported Administrative templates, and set the policies. Intune takes one language file for a template, and only the English one. A later version of the template has the same namespace, and Intune refuses a second upload of it: delete the profiles that use the imported template and the template itself, then import the new files. (Microsoft’s instructions.)
Without the templates. Any tool that writes the registry values above gives the same result, for example:
reg add HKLM\Software\Policies\SolidCraft /v CheckForUpdates /t REG_DWORD /d 0 /f
reg add HKLM\Software\Policies\SolidCraft /v OrganizationName /t REG_SZ /d "Example Corp" /f
Check that a policy applies
While any policy is set, the application bar shows a briefcase and Managed by with the
organization’s name (Managed by your organization without OrganizationName). A narrow
window shows Managed or the briefcase alone, and the tooltip has the whole text. Clicking it
opens Preferences, General. Preferences and About show the same line.
Open Preferences, General, Updates. With CheckForUpdates set, Check at start and once a day
is greyed out, shows the organization’s choice, and says Set by your organization. With the
value 0, Check now is unavailable too.
An agent or a script sees the same through the control channel: the reply of ui.prefs has a
policy object that lists the locked settings and the organization’s name, and a request that changes a locked setting is
refused (control protocol).
A policy is not a launcher
Managed by a launcher is about a program that installs and updates SolidCraft for one person. A policy is an organization’s setting. The two do not affect each other.