Skip to main content

Packages

A package describes a piece of software the agents can install or uninstall. Tenant admins create packages; technicians and viewers can see them and technicians can deploy them.

Global packages from Entrosity (marked Shared by the global admins) appear read-only next to your own and can be deployed like them.

Create a package​

Under Packages → New package, pick a kind:

KindWhat you provideNotes
MSIThe .msi fileProduct code and version are read from the file and used for detection and uninstall. Installed with msiexec /i … /qn /norestart.
EXEThe setup program and its install arguments (the silent switch, e.g. /S)Add uninstall arguments if the vendor has them. The command line is passed as you type it.
WingetA winget ID, found by searching the catalog (e.g. "7-Zip")Nothing is uploaded; devices install from winget. Optional version and source (winget or msstore).
PowerShellA .ps1 file or a pasted scriptRuns with -ExecutionPolicy Bypass as SYSTEM (or the user).

Uploaded files go straight from your browser to object storage. The server then checks the size and SHA-256 you declared, reads the MSI metadata, and marks the package ready. Until then it is a draft and cannot be deployed (package_not_ready). A ready package's file cannot be replaced: create a new package for a new version.

Common settings​

SettingMeaning
Name, publisher, version, descriptionShown in the library and in deployments.
ArchitectureThe CPU architecture the package is for.
Success exit codesDefault 0, 3010, 1641. 3010 and 1641 mean "succeeded, reboot required".
Timeout1 minute to 24 hours.
Run asSystem (default), or the logged-on user for per-user software. With nobody signed in, the job fails with no_logged_on_user.
Requires rebootThe package always needs a restart afterwards.

Detection rules​

A detection rule tells the agent whether the software is present:

  • before installing: if it passes, the device is marked Already installed (skipped) and nothing runs;
  • after installing: if it fails, the install is reported as failed (detection_failed);
  • after uninstalling: it must fail.
RuleChecks
MSI product codeThe product code is installed.
RegistryA key exists, or a value compares (==, !=, >=, >, <=, <) with an expected value. HKLM or HKCU, in both registry views.
FileA file exists, optionally with at least a minimum file version. Environment variables are expanded.
WingetThe winget package is installed.

Winget on devices without winget​

Devices without winget install App Installer from files the server hosts (ops upload them once; see Configuration → winget). Without them, winget packages fail on such devices with winget_missing.

Deleting a package​

Packages are soft-deleted: finished deployments keep showing them. A package used by a deployment that has not finished cannot be deleted (package_in_use). The file is removed after 7 days by default.