---
title: Documentation
description: Install BoxHaven, run remote boxes, manage teams and images, and self-host the backend.
---

# BoxHaven Documentation

BoxHaven runs remote development boxes for AI coding agents. Use these docs to
install the CLI, connect to a hosted or self-hosted backend, create boxes, run
agents inside persistent sessions, and operate the backend.

## Start here

- [Getting started](/getting-started): install `bh`, log in, create a box, run an agent, disconnect, reattach, and use normal SSH clients.
- [Agent skill](/agent-skill): install with Vercel's Skills CLI to teach Codex or Claude box creation, persistent agents, parallel tasks, project sync, and previews.
- [CLI reference](/commands): every command and flag for boxes, direct SSH, sync, teams, images, auth, and config.
- [Self-hosting](/self-hosting): run the Fastify/Better Auth control plane with your own provider credentials.

## Operate boxes

- [Teams](/teams): team-owned boxes, roles, invitations, and moving boxes between teams.
- [Golden images](/images): save, select, and remove team VM images by name.
- [Cloud providers](/providers): configure DigitalOcean and Hetzner Cloud provider settings.

## Security and operation

- [Security model](/security): short-lived SSH certificates, the backend user CA, and forwarded credentials.
- [External policy service](/operator-policy): optional create policy and native account-page integration for operators.

## Documentation for agents

[`llms.txt`](https://docs.boxhaven.dev/llms.txt) lists the documentation pages
and their Markdown URLs. For example,
[`commands.md`](https://docs.boxhaven.dev/commands.md) is the source of the CLI
reference. The website and these exports are built from the same files.

## Source and license

BoxHaven is open source under the GNU Affero General Public License v3.0 only
(`AGPL-3.0-only`). The source code, copyright notice, and full license text
live in the [BoxHaven GitHub repository](https://github.com/finbarr/boxhaven).