[{"data":1,"prerenderedAt":343},["ShallowReactive",2],{"docs-reporting-groups-":3,"docs-navigation":199},{"id":4,"title":5,"body":6,"dateModified":189,"datePublished":189,"description":190,"extension":191,"meta":192,"navigation":193,"path":194,"proficiencyLevel":195,"seo":196,"stem":197,"__hash__":198},"docs\u002Fdocs\u002F4.reporting\u002F4.groups.md","Groups in Open-AudIT",{"type":7,"value":8,"toc":182},"minimark",[9,14,18,23,26,64,68,83,86,144,148,151,168,171,175,178],[10,11,13],"h1",{"id":12},"groups","Groups",[15,16,17],"p",{},"Groups let you define a dynamic collection of devices that meet certain criteria. Think of a group as a saved filter — it's recalculated every time you view it.",[19,20,22],"h2",{"id":21},"what-are-groups-for","What Are Groups For?",[15,24,25],{},"Groups have several uses:",[27,28,29,40,46,52,58],"ul",{},[30,31,32,36,37],"li",{},[33,34,35],"strong",{},"Viewing"," — Browse all devices in a group from ",[33,38,39],{},"Menu → Report → Groups",[30,41,42,45],{},[33,43,44],{},"Filtering reports"," — Apply a group as a filter when running queries or summaries",[30,47,48,51],{},[33,49,50],{},"Baselining"," — Compare a group of devices against a known-good configuration",[30,53,54,57],{},[33,55,56],{},"Dashboard widgets"," — Use a group as the data source for a widget",[30,59,60,63],{},[33,61,62],{},"Targeting discoveries"," — Some advanced configurations allow targeting discoveries at a group",[19,65,67],{"id":66},"creating-a-group","Creating a Group",[69,70,71,77,80],"ol",{},[30,72,73,74],{},"Go to ",[33,75,76],{},"Menu → Manage → Groups → Create Groups",[30,78,79],{},"Give it a name and choose an organisation",[30,81,82],{},"Define the SQL WHERE clause that describes which devices belong to the group",[15,84,85],{},"For example, a group of all Windows Server devices:",[87,88,93],"pre",{"className":89,"code":90,"language":91,"meta":92,"style":92},"language-sql shiki shiki-themes github-light github-dark","WHERE @filter AND devices.os_family = 'Windows' AND devices.type = 'server'\n","sql","",[94,95,96],"code",{"__ignoreMap":92},[97,98,101,105,109,112,116,119,122,125,129,132,134,136,139,141],"span",{"class":99,"line":100},"line",1,[97,102,104],{"class":103},"szBVR","WHERE",[97,106,108],{"class":107},"sVt8B"," @filter ",[97,110,111],{"class":103},"AND",[97,113,115],{"class":114},"sj4cs"," devices",[97,117,118],{"class":107},".",[97,120,121],{"class":114},"os_family",[97,123,124],{"class":103}," =",[97,126,128],{"class":127},"sZZnC"," 'Windows'",[97,130,131],{"class":103}," AND",[97,133,115],{"class":114},[97,135,118],{"class":107},[97,137,138],{"class":114},"type",[97,140,124],{"class":103},[97,142,143],{"class":127}," 'server'\n",[19,145,147],{"id":146},"built-in-groups","Built-in Groups",[15,149,150],{},"Open-AudIT ships with several default groups, including:",[27,152,153,156,159,162,165],{},[30,154,155],{},"All Devices",[30,157,158],{},"Devices Not Seen in the Last 30 Days",[30,160,161],{},"Windows Devices",[30,163,164],{},"Linux Devices",[30,166,167],{},"Network Devices",[15,169,170],{},"You can use these as-is, copy and modify them, or create your own from scratch.",[19,172,174],{"id":173},"permissions","Permissions",[15,176,177],{},"Groups are Organisation-scoped — users only see devices within their permitted organisations when they view a group.",[179,180,181],"style",{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":92,"searchDepth":183,"depth":183,"links":184},2,[185,186,187,188],{"id":21,"depth":183,"text":22},{"id":66,"depth":183,"text":67},{"id":146,"depth":183,"text":147},{"id":173,"depth":183,"text":174},"2026-04-10","Learn how to use Groups in Open-AudIT to create dynamic collections of devices for filtering reports, building dashboards, and baselining configurations.","md",{},{"title":13},"\u002Fdocs\u002Freporting\u002Fgroups","Intermediate",{"title":5,"description":190},"docs\u002F4.reporting\u002F4.groups","5t32NaOfY68VHMqWnqB3Fgzjmo2q7HB6PILlARKvTvo",[200],{"title":201,"path":202,"stem":203,"children":204},"Docs","\u002Fdocs","docs",[205,209,221,243,274,292,299,321,338],{"title":206,"path":202,"stem":207,"description":208},"Overview","docs\u002Findex","Guides to help you install, configure, and get the most out of Open-AudIT — a powerful network discovery, audit, and asset tracking system.",{"title":210,"path":211,"stem":212,"children":213,"description":215},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[214,216],{"title":210,"path":211,"stem":212,"description":215},"Get from a fresh install to discovering devices on your network in under 10 minutes. This guide walks through each step in order.",{"title":217,"path":218,"stem":219,"description":220},"Activating Your License","\u002Fdocs\u002Fgetting-started\u002Factivating-your-license","docs\u002F1.getting-started\u002F2.activating-your-license","How to activate your free 100-device Open-AudIT Enterprise license after installation.",{"title":222,"path":223,"stem":224,"children":225,"description":227},"Installation","\u002Fdocs\u002Finstallation","docs\u002F2.installation\u002F1.index",[226,228,233,238],{"title":222,"path":223,"stem":224,"description":227},"Install or upgrade Open-AudIT on Windows Server or Linux. Includes virtual appliance option for the fastest setup.",{"title":229,"path":230,"stem":231,"description":232},"Server Requirements","\u002Fdocs\u002Finstallation\u002Fserver-requirements","docs\u002F2.installation\u002F2.server-requirements","Hardware, operating system, browser, and dependency requirements for running Open-AudIT.",{"title":234,"path":235,"stem":236,"description":237},"Install on Linux","\u002Fdocs\u002Finstallation\u002Finstall-linux","docs\u002F2.installation\u002F3.install-linux","Step-by-step guide to installing Open-AudIT on supported Linux distributions including Red Hat, Rocky Linux, Debian, and Ubuntu.",{"title":239,"path":240,"stem":241,"description":242},"Install on Windows","\u002Fdocs\u002Finstallation\u002Finstall-windows","docs\u002F2.installation\u002F4.install-windows","Step-by-step guide to installing Open-AudIT on Windows Server, including Nmap and Visual C++ prerequisites.",{"title":206,"path":244,"stem":245,"children":246,"description":248},"\u002Fdocs\u002Fdiscovery","docs\u002F3.discovery\u002F1.index",[247,249,254,259,264,269],{"title":206,"path":244,"stem":245,"description":248},"Discovery is how Open-AudIT finds and audits devices on your network. Learn about credentials, running scans, discovery types, and how it all works under the hood.",{"title":250,"path":251,"stem":252,"description":253},"Credentials","\u002Fdocs\u002Fdiscovery\u002Fcredentials","docs\u002F3.discovery\u002F2.credentials","Learn how to create and manage the credential sets Open-AudIT uses to authenticate with devices during network discovery.",{"title":255,"path":256,"stem":257,"description":258},"Running a Discovery","\u002Fdocs\u002Fdiscovery\u002Frunning-a-discovery","docs\u002F3.discovery\u002F3.running-a-discovery","Step-by-step guide to creating and running your first network discovery in Open-AudIT, including advanced options and scheduling.",{"title":260,"path":261,"stem":262,"description":263},"Discovery Types","\u002Fdocs\u002Fdiscovery\u002Fdiscovery-types","docs\u002F3.discovery\u002F4.discovery-types","Open-AudIT supports Subnet, Active Directory, and Seed discovery types. Learn when to use each and how they work.",{"title":265,"path":266,"stem":267,"description":268},"How It Works","\u002Fdocs\u002Fdiscovery\u002Fhow-discovery-works","docs\u002F3.discovery\u002F5.how-discovery-works","A detailed look at what Open-AudIT does during a discovery — from Nmap scanning through credential testing, audit script execution, and data processing.",{"title":270,"path":271,"stem":272,"description":273},"Matching Devices","\u002Fdocs\u002Fdiscovery\u002Fmatching-devices","docs\u002F3.discovery\u002F6.matching-devices","How Open-AudIT decides whether a discovered device is new or already exists in the database, and how to configure match rules to avoid duplicates.",{"title":275,"path":276,"stem":277,"children":278,"description":280},"Reporting","\u002Fdocs\u002Freporting","docs\u002F4.reporting\u002F1.index",[279,281,286,291],{"title":275,"path":276,"stem":277,"description":280},"Open-AudIT gives you multiple ways to pull meaningful information out of collected data using Queries, Summaries, and Reports.",{"title":282,"path":283,"stem":284,"description":285},"Queries, Summaries & Reports","\u002Fdocs\u002Freporting\u002Fqueries-summaries-reports","docs\u002F4.reporting\u002F2.queries-summaries-reports","Understand the three types of reporting in Open-AudIT — Queries, Summaries, and Reports — how they differ, and how to use filters and permissions.",{"title":287,"path":288,"stem":289,"description":290},"Creating a Query","\u002Fdocs\u002Freporting\u002Fcreating-a-query","docs\u002F4.reporting\u002F3.creating-a-query","Learn how to write custom SQL queries in Open-AudIT to extract device information, with examples for common use cases like warranty tracking and open ports.",{"title":13,"path":194,"stem":197,"description":190},{"title":293,"path":294,"stem":295,"children":296,"description":298},"Dashboards","\u002Fdocs\u002Fdashboards","docs\u002F5.dashboards\u002F1.index",[297],{"title":293,"path":294,"stem":295,"description":298},"Configure and customise Open-AudIT dashboards and widgets to create at-a-glance visual overviews of your network environment.",{"title":300,"path":301,"stem":302,"children":303,"description":305},"Administration","\u002Fdocs\u002Fadministration","docs\u002F6.administration\u002F1.index",[304,306,311,316],{"title":300,"path":301,"stem":302,"description":305},"Covers the ongoing administration of Open-AudIT including configuration, user management, permissions, and backup procedures.",{"title":307,"path":308,"stem":309,"description":310},"Configuration","\u002Fdocs\u002Fadministration\u002Fconfiguration","docs\u002F6.administration\u002F2.configuration","Key configuration settings in Open-AudIT covering discovery behaviour, change logging, data retention, and how to edit them.",{"title":312,"path":313,"stem":314,"description":315},"Users, Roles & Orgs","\u002Fdocs\u002Fadministration\u002Fusers-roles-orgs","docs\u002F6.administration\u002F3.users-roles-orgs","Understand Open-AudIT's role-based access control system including users, roles, organisations, LDAP integration, and permission inheritance.",{"title":317,"path":318,"stem":319,"description":320},"Backup & Restore","\u002Fdocs\u002Fadministration\u002Fbackup-restore","docs\u002F6.administration\u002F4.backup-restore","How to back up and restore your Open-AudIT database on Linux and Windows, including database reset procedures.",{"title":322,"path":323,"stem":324,"children":325,"description":327},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002F7.troubleshooting\u002F1.index",[326,328,333],{"title":322,"path":323,"stem":324,"description":327},"General troubleshooting guidance for Open-AudIT covering discovery problems, common errors, and first steps for diagnosing issues.",{"title":329,"path":330,"stem":331,"description":332},"Common Errors","\u002Fdocs\u002Ftroubleshooting\u002Fcommon-errors","docs\u002F7.troubleshooting\u002F2.common-errors","Explanations and solutions for common Open-AudIT error messages including MySQL lock errors, LDAP issues, Apache problems, and license screens.",{"title":334,"path":335,"stem":336,"description":337},"Discovery Problems","\u002Fdocs\u002Ftroubleshooting\u002Fdiscovery-problems","docs\u002F7.troubleshooting\u002F3.discovery-problems","Troubleshoot Open-AudIT discovery issues including devices not found, duplicate records, Nmap problems, stuck queues, and cross-platform auditing.",{"title":339,"path":340,"stem":341,"description":342},"Release Notes","\u002Fdocs\u002Frelease-notes","docs\u002Frelease-notes","What's new in each Open-AudIT release — features, fixes, and improvements.",1779233235220]