---
title: The basics of installing and configuring the K12Panel Agent
description: Install the K12Panel Agent on Windows PCs using the customized Updater MSI, the command line, PowerShell, or GPO.
---

[Skip to content](https://k12panel.com/kb/k12panel-agent/the-basics-of-installing-and-configuring-the-k12panel-agent#main-content)

![test-full-word-logo.png\]](https://k12panel.com/hs-fs/hubfs/test-full-word-logo.png?height=35&name=test-full-word-logo.png)

Open main navigation

Close main navigation

- [Go to k12panel.com](https://k12panel.com)

[Go to k12panel.com](https://k12panel.com?hsLang=en)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Online Help and Knowledge Base](https://k12panel.com/kb?hsLang=en)
2. [K12Panel Agent](https://k12panel.com/kb/k12panel-agent?hsLang=en)

# 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.

- [Getting started](https://k12panel.com/kb/getting-started?hsLang=en)
- [Menu Functions](https://k12panel.com/kb/menu-functions?hsLang=en)
- [Settings](https://k12panel.com/kb/settings?hsLang=en)
- [3rd Party Integrations](https://k12panel.com/kb/3rd-party-integrations?hsLang=en)
- [PC Health and SOAR](https://k12panel.com/kb/pc-health-and-soar?hsLang=en)
- [FAQ](https://k12panel.com/kb/faq?hsLang=en)
- [K12Panel Agent](https://k12panel.com/kb/k12panel-agent?hsLang=en)
- [Blueprints Catalog](https://k12panel.com/kb/blueprints-catalog?hsLang=en)
- [Writing your own Blueprint](https://k12panel.com/kb/writing-your-own-blueprint?hsLang=en)
- [MSP Tools](https://k12panel.com/kb/msp-tools?hsLang=en)
- [Developer API](https://k12panel.com/kb/developer-api?hsLang=en)

# K12Panel Inc

k12panel.com Help Center

Copyright © 2026, K12Panel Inc