docs: troubleshooting guide for the laptop install
Open
@mrsabath is already working on this.
Since Sep 10, 2026.
documentation
high priority
- Dominant language
- Go
- Stars
- 13
- Forks
- 40
- Avg merge
- 12h 17m
- Merged PRs (30d)
- 156
Description
Feature Description
What actually goes wrong with a laptop install has no page.
Proposed Solution
- CA not trusted: how to tell, how to fix
- Port 47600 already in use
- Service will not start, or starts and dies — launchd and systemd
- Another tool broke — cross-reference the tool-compatibility issues (#946, #947)
- No events appearing though the agent is running
- Numbers look wrong or missing
- Where the logs are, and what to attach to a bug report
Additional Context
Part of the Cortex v0.9.0 release.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.