Frequently asked questions
Short answers to the questions operators ask most. Each answer links to the guide with the full steps.
Compliance and results
Why is my host NON-COMPLIANT?
At least one rule assigned to the host fails. Open the host page → Rule results tab and click Failing to see which rules. Click a FAIL pill to see the output and the expectation that failed. See How to read a result.
What is the difference between FAIL and INFO?
FAIL means the rule ran and the output did not meet the rule's expectations. INFO means there is no PASS/FAIL verdict: the rule has no expectations, it has not run on that host yet, or it could not be evaluated. See Status words.
Why does a host show NO RESULTS?
No rule has produced a result on it yet. Usually the host is in no active group with active rules, it is inactive, or its agent is not reporting. See A rule shows INFO or NO RESULTS.
What does INFO mean?
The result has no PASS/FAIL verdict. Either the rule is informational (it has no expectations, so it only collects data, for example the host name or installed packages), or it has not produced a usable result on that host yet. It never affects compliance.
How often do rules run?
Each rule has its own interval, set in the rule editor as Interval (seconds). The default is 3600 seconds (one hour). Separately, the agent checks in with the server every 30 seconds by default to collect work.
I fixed the host. When will LEA show PASS?
At the rule's next run on that host, at most one rule interval later. There is no button to run a rule immediately. To confirm your fix right away, an administrator can run the rule's command on the host's Terminal tab and compare the output.
Why does the Dashboard score differ from the Compliance rate?
They measure different things. The Dashboard score weights each failure by severity (a critical failure counts 16 times as much as an informative one). The Compliance rate on the Compliance page simply counts compliant hosts out of all hosts with results. See Compliance score.
A rule fails, but I am sure the host is configured correctly. What now?
Read the result's raw output first: the cause is usually a file the agent cannot read, a setting stored in another file, or a pattern that does not fit your format. See A rule shows FAIL but the host is fine.
Hosts and agents
Does the agent need root?
No. On Linux the standard install script runs the agent as a dedicated user, lea, with no sudo rights, and rule commands are written to only read state. On Windows the service runs as the service account NT SERVICE\LEAAgent, which is not an administrator. Hosts installed by an older version keep their old rights until you update them: Remove the old rights from existing hosts.
Can a rule break my server?
Checks are designed not to: validation commands only read state, such as cat /etc/ssh/sshd_config. Changes happen only through remediation, which is off for library rules until an administrator turns it on, and through commands an administrator runs on the Terminal tab. Rules are written by administrators, so review any custom rule's commands on its Definition tab.
Warning: A remedy runs automatically on every failing host that has the rule. Always try it on a small test group first.
What does the agent send to the server?
The raw output of the rule commands (stdout, stderr and exit code), basic host information (such as operating system, distribution and IP address) and its own log messages. Pass or fail is decided on the server.
Can I run a command on one host now?
Yes, if you are an administrator. Open the host page → Terminal tab, type the command and press Enter. It runs on the host's next check-in (within about 30 seconds); Speed up check-ins makes this faster. You get a notification when the output arrives. Interactive commands (editors, shells, top) are rejected and destructive commands are blocked; every attempt is in the audit log. See Hosts.
How do I add a new host?
Create a deployment token in Settings → Deployment tokens, install the LEA agent on the machine with that token, and wait for it to appear on Compliance. See Agent enrollment and Hosts.
How do I add a host to a group automatically?
Three ways:
| Method | Where | When to use it |
|---|---|---|
| Deployment token with a group | Settings → Deployment tokens → Group | Every host enrolled with this token joins that group. |
| All hosts group | Group editor → Hosts → All hosts | Every host should run these rules. |
| JSONPath group | Group editor → Hosts → JSONPath | Membership follows host data, for example host names that contain "db". |
See Groups.
A machine was rebuilt or cloned and shows "Certificate error". What do I do?
Open the host page → Overview → Re-enroll, choose a window and click Open Window. After its next check-in the host is in Probation. Check it is the right machine, then click Confirm. See Agent enrollment.
How do I remove a host?
On Compliance (administrators), click the checkbox icon at the left end of the table header (Select mode), select the host, click the delete button (bin icon) below the table and confirm. Also uninstall the agent from the machine.
Rules and groups
How do I add rules from the library?
Open Rules → Add from library. Filter by Category, Framework or Platform, select rules and click Add. New rules start unassigned unless you choose a group in Add to group (optional). See Rules.
How do I write my own rule?
Click New rule on the Rules page. Fill in General, the Validations (the read-only commands) and the Expectations (the expected output). See Rules.
How do I turn remediation on?
Library rules keep their fix documented but switched off. To turn it on:
- Open the rule page → Definition → Show JSON and find the commands under
_remedy. - Click Edit rule, open the Remediations section and add those commands.
- Click Save rule and choose who gets the change: All hosts now or New hosts only.
Warning: Remedies run automatically on every failing host. Test on a small group first. See Remediation.
How do I run a rule on only some hosts?
Put those hosts in a group and add the rule to that group. A host runs every active rule of every active group it belongs to. See Groups.
Who changed this rule?
Open Audit (administrators) → Configuration changes. Find the rule's name in Record Name; Actor shows who made the change. Click the row to see the details. The rule page → Versions tab shows every version of the rule's definition and when it was created.
How do I undo a rule change?
Open the rule page → Versions, find the earlier version and click Apply. Choose All hosts now or New hosts only. See Rule updates.
Why do some hosts run an older version of a rule?
The change was rolled out with New hosts only, so hosts that already ran the rule were held on their version. Open the rule page → Versions or the host page → Held rules and click Update or Update all.
Reports and audit
How do I export a report for an auditor?
Open Reports → Frameworks & evidence. For the framework, click PDF, or Stakeholder Report and choose GRC (External Auditor). See Reports.
How do I prove the evidence was not changed?
Evidence snapshots are sealed with an HMAC when they are taken. Changing a record afterwards no longer matches its MAC, unless someone with the evidence sealing key recomputed it. Enable the framework and its schedule in Settings → Compliance frameworks, or click Snapshot on Reports to take one now.
How do I add a rule to a framework?
Add a tag of the form std:<FRAMEWORK>:<control> to the rule, for example std:ISO27001:A.8.7. Edit the rule → General → tags. See Compliance.
How do I export the audit log?
Open Audit, choose the tab and filters, then click the export button (download arrow) in the page header.
The console and your account
How do I change my theme?
Click the appearance button in the top bar and choose Light, Dark or Auto (system).
How do I find a host or rule quickly?
Press Ctrl K (⌘ K on Mac) or click Search… in the top bar, then type part of the name. Right-click an item → Pin for quick access to keep it at the top of the search list.
How do I share exactly what I see?
Copy the address from your browser: filters are part of it. For a single host, rule or result, right-click it → Copy link.
How do I stop a noisy notification?
In the bell, use Mute on the notification and choose how long. Manage mutes under account menu → Account settings → Muted. See Notifications.
Why can I not see Audit or Settings?
Those pages are for administrators. You have the read-only role. See roles.
Network and platform
Does LEA Platform need internet?
No. Agents talk only to your LEA server. Rule updates arrive as signed rule packs that you import from a file. The AI assistant can use a model on your own network. Only Slack, Teams and internet-based AI providers need outside access. See Air-gapped sites.
How do I update rules without internet?
Copy the signed rule pack (lea-rules-<version>.tgz and its .sig) to a machine that can reach the console. Import it in Settings → Rule sources under Import a rule pack, then review and apply changes in Rules → Updates. Importing changes nothing on hosts by itself. See Rule updates.
Is my data sent to an AI service?
Only if an administrator turns on the AI assistant and chooses a provider in Settings → AI Assistant. The provider can be a model running on your own network. Conversations are kept in your browser. See AI assistant.
What happens when the license expires?
LEA Platform keeps working during a grace period; the top bar shows how many days are left. Renew in Settings → License. See License warnings.