> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxlite.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Guides

> Practical how-to guides for building, configuring, and integrating BoxLite into your projects.

These guides cover advanced topics: building from source, AI agent integration patterns, image registry configuration, and debugging. Each guide is self-contained and can be read independently.

<Tip>
  Looking for step-by-step task tutorials? See the [Tutorials](/tutorials/index) section for code execution, file transfer, LLM integration, and browser automation walkthroughs.
</Tip>

## All guides

<CardGroup cols={2}>
  <Card title="Building from Source" icon="hammer" href="/guides/building-from-source">
    Clone the repository, install prerequisites, and build BoxLite for macOS or Linux using the provided Makefile targets and build scripts.
  </Card>

  <Card title="AI Agent Integration" icon="robot" href="/guides/ai-agent-integration">
    Production patterns for AI agent sandboxing — configuration, security presets, concurrency, timeout handling, and terminal resizing.
  </Card>

  <Card title="Image Registry Configuration" icon="box-archive" href="/guides/image-registry-configuration">
    Configure BoxLite to pull OCI container images from custom registries, private enterprise registries, or local caching proxies.
  </Card>

  <Card title="macOS Sandbox Debugging" icon="apple" href="/guides/macos-sandbox-debugging">
    Debug macOS Seatbelt sandbox policy issues during development — real-time log monitoring, SBPL syntax, and common denial patterns.
  </Card>

  <Card title="Changelog" icon="clock-rotate-left" href="/guides/changelog">
    Version history and release notes — track what's new, improved, and fixed in each BoxLite release.
  </Card>
</CardGroup>

## Additional Topics

The source README also covers networking, volume mounting, debugging, resource tuning, deployment patterns, and integration examples. These topics are woven into the guides above and the [Architecture](/architecture/index) and [SDK Reference](/reference/index) sections.

<Tip>
  New to BoxLite? Start with the [Getting Started](/getting-started/index) guide, then work through the [Tutorials](/tutorials/index) before diving into these advanced guides.
</Tip>