> For the complete documentation index, see [llms.txt](https://docs.hex-rays.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless.md).

# Headless License

Headless licenses are the license type for scripts, pipelines and AI agents, with headless seats served by the License Server. Use them with IDA Pro Headless, the IDA analysis engine without the GUI.

Run binary analysis at scale, build IDA into agentic workflows, or embed the IDA engine in your own product. A headless license works like a floating license and comes from the same License Server, but its seats go to your automation instead of your analysts.

{% hint style="info" icon="desktop-arrow-down" %}

### Quick download with HCLI

Download the package for your platform with [HCLI](https://hcli.docs.hex-rays.com/), then pick **IDA Pro Headless** in the list:

```bash
uvx ida-hcli download
```

Check [Getting Started](https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/getting-started.md) to point it at your license server and analyze your first binary in a few minutes.
{% endhint %}

## Basic Resources

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3>Overview</h3></td><td>What IDA Pro Headless is, what it is made for, and how it differs from IDA Pro on an analyst's desk</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/overview.md">Overview</a></td></tr><tr><td><h3>Getting Started</h3></td><td>Unzip the package, accept the license agreement, connect to your license server and analyze a binary</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/getting-started.md">Getting Started</a></td></tr></tbody></table>

## Going deeper

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h3>Headless seats</h3></td><td>How scripts and agents check out seats, and how to size your pool for concurrent scripts and agents</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/concepts/headless-seats.md">Headless seats</a></td></tr><tr><td><h3>Package contents</h3></td><td>What ships in each platform package, and which platforms are supported</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/reference/package-contents.md">Package contents</a></td></tr></tbody></table>

## Try it yourself

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Use IDA Pro Headless with coding agents</strong></td><td>Point your agent at the package, or give it IDA as tools through IDA MCP</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/how-tos/use-with-coding-agents.md">Use IDA Pro Headless with coding agents</a></td></tr><tr><td><strong>Run IDA Pro Headless in Docker</strong></td><td>Build an image from the package and run one container per binary</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/how-tos/run-in-docker.md">Run IDA Pro Headless in Docker</a></td></tr><tr><td><strong>Work offline with a borrowed seat</strong></td><td>Borrow a seat for a machine that cannot reach the license server</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/how-tos/work-offline.md">Work offline with a borrowed seat</a></td></tr><tr><td><strong>Wait for a free seat</strong></td><td>Let a batch of scripts queue for seats instead of failing</td><td><a href="https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless/how-tos/wait-for-a-free-seat.md">Wait for a free seat</a></td></tr></tbody></table>

## Admin Resources

[Guidance for administrators](https://docs.hex-rays.com/editions-and-licenses/license-server/admin/headless-license-server-setup.md) who prepare the license server and the network for IDA Pro Headless.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hex-rays.com/editions-and-licenses/license-types/ida-pro-headless.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
