diff --git a/README.md b/README.md
index e272203..465a262 100644
--- a/README.md
+++ b/README.md
@@ -18,6 +18,32 @@
 | `llama.cpp` | b8680 | LLM 推論引擎 (Metal backend 已驗證) |
 | `ggml` | 0.9.11 | llama.cpp 依賴 |
 
+## 容器 (Apple `container`)
+
+Apple 原生容器 runtime,取代已移除的 OrbStack/Docker。**非 Homebrew** — 由官方簽章 `.pkg` 安裝,裝在 `/usr/local/bin`。
+
+| 項目 | 值 |
+|---|---|
+| 版本 | 1.1.0 |
+| 需求 | Apple Silicon + macOS 26 |
+| 安裝來源 | [github.com/apple/container](https://github.com/apple/container) releases 的 `container-<ver>-installer-signed.pkg` |
+
+```bash
+# 安裝 (需 sudo,要在真正的 Terminal 跑)
+sudo installer -pkg container-1.1.0-installer-signed.pkg -target /
+
+# 首次啟動 + 非互動裝 kata kernel
+container system start --enable-kernel-install
+
+# 常用
+container run --rm docker.io/library/alpine echo hi   # 跑容器
+container images ls        # 列 image
+container ls               # 列執行中容器
+container system status    # 服務狀態
+```
+
+> ⚠️ `container system start` 若不加 `--enable-kernel-install`,會**互動詢問**是否下載預設 kernel;非互動 SSH 沒 stdin 會 `Error: failed to read user input`,固定用該 flag。
+
 ## 已下載模型
 
 | 模型 | 路徑 | 大小 | 速度 |