Skip to content
Go to k12panel.com
  • There are no suggestions because the search field is empty.

The basics of installing and configuring the K12Panel Agent

Add a Windows PC as an Asset by installing the K12Panel Agent — the customized Updater MSI is the preferred method.

Installing and Configuring the K12Panel Agent

To add a Windows PC as an Asset, install the K12Panel Agent on it. The Agent registers the machine on your On-Ramp and runs Modifiers once the asset is adopted and activated. The customized Updater MSI is the preferred installer.

Ways to Install the Agent

  • Using the Updater MSI customized for your organization (preferred).
  • Manually installing the non-customized MSI and entering the Organization ID during setup.
  • Silently from the command line with the OrgID passed as a parameter.
  • Silently via PowerShell with the OrgID passed.
  • Silently via PowerShell deployed through GPO.
  • Via a DNS TXT record that supplies the OrgID (deprecated).

1. Customized Updater MSI (Preferred)

Download the custom MSI installer for your organization from Settings → Software Downloads. Double-click it and follow the prompts — the OrgID is already embedded, so you do not need to enter it. You can also install it silently, for example:

msiexec /passive /i \\path\to\k12panel_YOURORG_updater.msi

2. Manual Installation

Run the MSI’s graphical wizard. When prompted, enter your Organization ID to bind the asset to your organization.

3. Command Line with OrgID

Pass the OrgID as a parameter:

msiexec /passive /i \\path\to\installer.msi orgid=YOUR-ORG-GUID

Use your organization’s actual OrgID, found under Settings → Organization Overview.

4. PowerShell with OrgID

Start-Process msiexec.exe -ArgumentList “/passive /i \\path\to\k12panel-setup.msi orgid=YOUR-ORG-GUID” -Wait

5. PowerShell via GPO

Place a script like the following in a network location your machines can reach, changing the path, file name, and OrgID for your environment. It installs the Agent only if it isn’t already present:

$installed = Get-ItemProperty -Path “HKLM:\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*” | Where-Object {$_.DisplayName -eq “K12Panel Service Agent”}
if (!($installed)) { Start-Process msiexec.exe -ArgumentList “/passive /i \\path\to\k12panel-setup.msi orgid=YOUR-ORG-GUID” -Wait }

Create a GPO under Computer Configuration → Windows Settings → Scripts (Startup/Shutdown) → Startup that runs this PowerShell script, and deploy it to the machines that need the Agent.

6. DNS TXT Record (Deprecated)

Supplying the OrgID via a DNS TXT record is deprecated. Use one of the methods above. The DNS approach is documented separately for organizations still running legacy Agent versions.

Common Questions

Which installer should I use?
The customized Updater MSI from Settings → Software Downloads — it already contains your OrgID.

Where do I find my Organization ID?
Under Settings → Organization Overview.

Can I deploy the Agent silently to many PCs?
Yes — via msiexec on the command line, PowerShell, or a startup-script GPO.

How do I install on a generic image without binding an org yet?
Install without the orgid parameter, then set the OrgID later (for example during ReimageAny or imaging).

The PC installed but isn’t in Panel — what next?
See the FAQ on PC hosts not showing up after installing the Agent.