Skip to main content
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.
Looking for step-by-step task tutorials? See the Tutorials section for code execution, file transfer, LLM integration, and browser automation walkthroughs.

​
All guides

Building from Source

Clone the repository, install prerequisites, and build BoxLite for macOS or Linux using the provided Makefile targets and build scripts.

AI Agent Integration

Production patterns for AI agent sandboxing — configuration, security presets, concurrency, timeout handling, and terminal resizing.

Image Registry Configuration

Configure BoxLite to pull OCI container images from custom registries, private enterprise registries, or local caching proxies.

macOS Sandbox Debugging

Debug macOS Seatbelt sandbox policy issues during development — real-time log monitoring, SBPL syntax, and common denial patterns.

Changelog

Version history and release notes — track what’s new, improved, and fixed in each BoxLite release.

​
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 and SDK Reference sections.
New to BoxLite? Start with the Getting Started guide, then work through the Tutorials before diving into these advanced guides.