# Farrow 文档

> 安装 Farrow、启动 Pigsty Inventory、维护唯一 deployment，并查阅准确的配置与命令契约。

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

Farrow 把一份 Pigsty 兼容的 Inventory 启动成固定 IP 的 QEMU 虚拟机。每个 Unix
用户只有一套 deployment，状态位于 `~/.farrow`，因此生命周期与 SSH 命令可在任意
目录运行。

按任务选择最短路径：

- **[开始使用](start/)**：安装、第一个实验环境、日常操作与排障。
- **[参考](reference/)**：Inventory 字段、命令、参数、输出与退出码。
- **[关于](about/)**：简化设计、真机验证、已知限制与发布门禁。

新手直接跟随[教程](start/tutorial/)即可。正常路径只有三步：`farrow setup`、
`farrow up`、`farrow status`。

> [!IMPORTANT]
> Farrow 仍是 pre-1.0。当前源码、真机验证、打包、发布与线上站点是不同门禁。
> 依赖开发构件前请阅读[当前状态](about/status/)。

---

本节页面：

- [开始使用](/zh/docs/start/): 安装 Farrow，启动单节点或四节点，维护 deployment，并解决常见故障。
- [参考](/zh/docs/reference/): Farrow 读取的 Pigsty Inventory 与命令行的准确契约。
- [关于 Farrow](/zh/docs/about/): 简化后的产品模型、实现边界、真机证据、当前限制与发布门禁。