[{"data":1,"prerenderedAt":367},["ShallowReactive",2],{"docs-administration-configuration-":3,"docs-navigation":223},{"id":4,"title":5,"body":6,"dateModified":213,"datePublished":213,"description":214,"extension":215,"meta":216,"navigation":217,"path":218,"proficiencyLevel":219,"seo":220,"stem":221,"__hash__":222},"docs\u002Fdocs\u002F6.administration\u002F2.configuration.md","Open-AudIT Configuration",{"type":7,"value":8,"toc":204},"minimark",[9,14,23,28,31,132,136,139,154,158,165,169,179,183,201],[10,11,13],"h1",{"id":12},"configuration","Configuration",[15,16,17,18,22],"p",{},"Open-AudIT has a large number of configuration settings that control everything from discovery behaviour to change logging. You can find them all under ",[19,20,21],"strong",{},"Menu → Admin → Configuration → List Configuration",".",[24,25,27],"h2",{"id":26},"key-settings-to-check-after-installation","Key Settings to Check After Installation",[15,29,30],{},"After a fresh install, it's worth reviewing these settings before running your first discovery:",[32,33,34,50],"table",{},[35,36,37],"thead",{},[38,39,40,44,47],"tr",{},[41,42,43],"th",{},"Setting",[41,45,46],{},"What It Does",[41,48,49],{},"Recommendation",[51,52,53,68,81,106,119],"tbody",{},[38,54,55,62,65],{},[56,57,58],"td",{},[59,60,61],"code",{},"default_network_address",[56,63,64],{},"The URL that external devices use to reach Open-AudIT (used when copying audit scripts to targets)",[56,66,67],{},"Set this to your server's actual IP or hostname",[38,69,70,75,78],{},[56,71,72],{},[59,73,74],{},"discovery_limit",[56,76,77],{},"Maximum number of parallel discovery processes",[56,79,80],{},"Default is 20; increase for faster scanning on capable hardware",[38,82,83,88,91],{},[56,84,85],{},[59,86,87],{},"discovery_linux_script_directory",[56,89,90],{},"Where the audit script is copied on Linux targets",[56,92,93,94,97,98,101,102,105],{},"Default is ",[59,95,96],{},"\u002Ftmp\u002F","; change if ",[59,99,100],{},"\u002Ftmp"," has ",[59,103,104],{},"noexec"," set",[38,107,108,113,116],{},[56,109,110],{},[59,111,112],{},"log_level",[56,114,115],{},"Logging verbosity",[56,117,118],{},"Default is 5; set to 7 for detailed debugging",[38,120,121,126,129],{},[56,122,123],{},[59,124,125],{},"discovery_ip_exclude",[56,127,128],{},"IP addresses to skip during discovery",[56,130,131],{},"Add any IPs you never want scanned",[24,133,135],{"id":134},"change-logging","Change Logging",[15,137,138],{},"By default, Open-AudIT logs changes to almost every component table — software, disks, network interfaces, services, and more. This is incredibly useful for tracking what changed on a device and when.",[15,140,141,142,145,146,149,150,153],{},"The change log settings follow the pattern ",[59,143,144],{},"create_change_log_tablename",". Most are enabled by default. You might want to disable change logging for high-churn tables that generate a lot of noise, like ARP (",[59,147,148],{},"create_change_log_arp",") or IP (",[59,151,152],{},"create_change_log_ip",").",[24,155,157],{"id":156},"data-retention","Data Retention",[15,159,160,161,164],{},"Related to change logging is the cleanup of \"non-current\" data. When a component (e.g., a piece of software) is no longer detected on a device, Open-AudIT marks it as non-current rather than deleting it immediately. Settings like ",[59,162,163],{},"delete_noncurrent_software"," control whether and when that historical data is deleted.",[24,166,168],{"id":167},"discovery-defaults","Discovery Defaults",[15,170,171,172,175,176,22],{},"The ",[59,173,174],{},"discovery_default_scan_option"," setting controls which Nmap scan profile is used as the default for new discoveries. You can review and customise scan profiles under ",[19,177,178],{},"Menu → Discover → Discovery Scan Options",[24,180,182],{"id":181},"editing-configuration","Editing Configuration",[184,185,186,192,195,198],"ol",{},[187,188,189,190],"li",{},"Go to ",[19,191,21],{},[187,193,194],{},"Use the search box to find the setting you want",[187,196,197],{},"Click the edit icon next to the setting",[187,199,200],{},"Update the value and save",[15,202,203],{},"Changes to most configuration items take effect immediately — no restart required.",{"title":205,"searchDepth":206,"depth":206,"links":207},"",2,[208,209,210,211,212],{"id":26,"depth":206,"text":27},{"id":134,"depth":206,"text":135},{"id":156,"depth":206,"text":157},{"id":167,"depth":206,"text":168},{"id":181,"depth":206,"text":182},"2026-04-10","Key configuration settings in Open-AudIT covering discovery behaviour, change logging, data retention, and how to edit them.","md",{},{"title":13},"\u002Fdocs\u002Fadministration\u002Fconfiguration","Intermediate",{"title":5,"description":214},"docs\u002F6.administration\u002F2.configuration","G84x08UmuVEb35fnjhXTQP8Nk5MNTh_l1vxAx9IqL-s",[224],{"title":225,"path":226,"stem":227,"children":228},"Docs","\u002Fdocs","docs",[229,233,245,267,298,320,327,345,362],{"title":230,"path":226,"stem":231,"description":232},"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":234,"path":235,"stem":236,"children":237,"description":239},"Getting Started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[238,240],{"title":234,"path":235,"stem":236,"description":239},"Get from a fresh install to discovering devices on your network in under 10 minutes. This guide walks through each step in order.",{"title":241,"path":242,"stem":243,"description":244},"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":246,"path":247,"stem":248,"children":249,"description":251},"Installation","\u002Fdocs\u002Finstallation","docs\u002F2.installation\u002F1.index",[250,252,257,262],{"title":246,"path":247,"stem":248,"description":251},"Install or upgrade Open-AudIT on Windows Server or Linux. Includes virtual appliance option for the fastest setup.",{"title":253,"path":254,"stem":255,"description":256},"Server Requirements","\u002Fdocs\u002Finstallation\u002Fserver-requirements","docs\u002F2.installation\u002F2.server-requirements","Hardware, operating system, browser, and dependency requirements for running Open-AudIT.",{"title":258,"path":259,"stem":260,"description":261},"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":263,"path":264,"stem":265,"description":266},"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":230,"path":268,"stem":269,"children":270,"description":272},"\u002Fdocs\u002Fdiscovery","docs\u002F3.discovery\u002F1.index",[271,273,278,283,288,293],{"title":230,"path":268,"stem":269,"description":272},"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":274,"path":275,"stem":276,"description":277},"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":279,"path":280,"stem":281,"description":282},"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":284,"path":285,"stem":286,"description":287},"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":289,"path":290,"stem":291,"description":292},"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":294,"path":295,"stem":296,"description":297},"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":299,"path":300,"stem":301,"children":302,"description":304},"Reporting","\u002Fdocs\u002Freporting","docs\u002F4.reporting\u002F1.index",[303,305,310,315],{"title":299,"path":300,"stem":301,"description":304},"Open-AudIT gives you multiple ways to pull meaningful information out of collected data using Queries, Summaries, and Reports.",{"title":306,"path":307,"stem":308,"description":309},"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":311,"path":312,"stem":313,"description":314},"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":316,"path":317,"stem":318,"description":319},"Groups","\u002Fdocs\u002Freporting\u002Fgroups","docs\u002F4.reporting\u002F4.groups","Learn how to use Groups in Open-AudIT to create dynamic collections of devices for filtering reports, building dashboards, and baselining configurations.",{"title":321,"path":322,"stem":323,"children":324,"description":326},"Dashboards","\u002Fdocs\u002Fdashboards","docs\u002F5.dashboards\u002F1.index",[325],{"title":321,"path":322,"stem":323,"description":326},"Configure and customise Open-AudIT dashboards and widgets to create at-a-glance visual overviews of your network environment.",{"title":328,"path":329,"stem":330,"children":331,"description":333},"Administration","\u002Fdocs\u002Fadministration","docs\u002F6.administration\u002F1.index",[332,334,335,340],{"title":328,"path":329,"stem":330,"description":333},"Covers the ongoing administration of Open-AudIT including configuration, user management, permissions, and backup procedures.",{"title":13,"path":218,"stem":221,"description":214},{"title":336,"path":337,"stem":338,"description":339},"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":341,"path":342,"stem":343,"description":344},"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":346,"path":347,"stem":348,"children":349,"description":351},"Troubleshooting","\u002Fdocs\u002Ftroubleshooting","docs\u002F7.troubleshooting\u002F1.index",[350,352,357],{"title":346,"path":347,"stem":348,"description":351},"General troubleshooting guidance for Open-AudIT covering discovery problems, common errors, and first steps for diagnosing issues.",{"title":353,"path":354,"stem":355,"description":356},"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":358,"path":359,"stem":360,"description":361},"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":363,"path":364,"stem":365,"description":366},"Release Notes","\u002Fdocs\u002Frelease-notes","docs\u002Frelease-notes","What's new in each Open-AudIT release — features, fixes, and improvements.",1779864900752]