Docs
How Borehole works inside
What runs where, what crosses from your repository, and the documents a security or legal review asks for. Each page states what the code does, and the numbers on it are read from the code.
Concepts
- Architecture
- What runs where in a public survey and in a private one, and what crosses between them.
- Keys and tokens
- A Report key is what you paid for. A collector token lets the collector act for your account. How the two differ.
Your code and data
- What happens to your code
- Everything the collector sends from a private repository, how to check it before it is sent, and what we still cannot prove.
- Run it in your own cloud
- The collector in a Confidential VM in your own Google Cloud project, with every command.
- Surveying a target
- How a buyer surveys a private target: the target runs the collector with the buyer's key and decides who reads the report.
- Verify a report
- Check a Borehole reading's code: what it says, and whether the page still matches it.
- Attestation
- What a report records about where its survey ran, and how to check it without trusting us.
Legal and security
- Sub-processors
- Every service that receives data Borehole holds, and what each one gets.
- Data processing agreement
- The agreement under which we process personal data in a private survey, as your processor.
- Reporting a vulnerability
- How to report a vulnerability in borehole.dev or the collector.
- Terms
- The terms you accept when you buy or use Borehole.
- Privacy
- What we hold about you, why, for how long, and your rights.
Guides
- Due diligence checklist
- What to check in a software company's code before you buy it or sell it, why a buyer cares, and the command for each.
- Preparing for due diligence
- What a software company fixes, writes down and leaves alone before a buyer reads its code.
- AGPL, BUSL and SSPL
- What each licence obliges when a software company is bought or sold, what a buyer asks, and how to check the code.
- Was this app vibe-coded?
- How to tell if an app's code is AI-generated, and what a repository can and can't show.
- Questions to ask the CTO
- What a buyer asks a software company's CTO in due diligence, and which answers the code can check.