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

Configuring DNS to allow automatic detection of OrgID

A deprecated legacy method — a DNS TXT record can supply the OrgID to generic K12Panel Agents.

Configuring DNS to Detect the OrgID (Deprecated)

This method is deprecated and should not be used for new deployments. It is supported only for organizations running legacy versions of the K12Panel Agent. The preferred way to set the Organization ID is during Agent installation — see “Installing and Configuring the K12Panel Agent.”

How the DNS Entry Works

You add a DNS TXT record to your local DNS server so that Agents can detect the correct OrgID at registration. The record lives at orgid.k12panel with no TLD extension (no .com, .net, and so on). Do not create a zone for k12panel.com.

Active Directory DNS

  • Open DNS from Server Manager.
  • Right-click Forward Lookup Zones and create a new zone, following the wizard defaults.
  • When asked for the zone name, enter k12panel.
  • Right-click the new k12panel zone and choose Other New Record.
  • Select Text (TXT) and click Create Record.
  • For the record name, enter orgid.
  • For the text value, paste your OrgID from K12Panel Settings.
  • Save and close DNS.

pfSense Unbound

  • Sign in to the pfSense web interface.
  • Go to Services → DNS Resolver.
  • Under General Settings, open Display Custom Options.
  • Add a custom option that publishes a TXT record for orgid.k12panel containing your OrgID.
  • Save and apply changes.

Be careful with single and double quotes in the Unbound custom options — a quoting mistake will stop the TXT record from working.

Testing the DNS Entry

From a Windows command prompt, run:

nslookup -type=txt orgid.k12panel

A working entry returns your OrgID as the TXT text value.

Common Questions

Should I use this method?
No. It is deprecated. Set the OrgID during Agent installation instead.

What name does the TXT record use?
orgid.k12panel, with no TLD — do not create a k12panel.com zone.

How do I verify it works?
Run nslookup -type=txt orgid.k12panel; it should return your OrgID.