From 133ed56d4bf748439367648c5e97433a999ddcc3 Mon Sep 17 00:00:00 2001
From: Timmy <loyangchun@gmail.com>
Date: Sat, 20 Jun 2026 23:20:35 +0800
Subject: [PATCH] Add README

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ca90cb8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,32 @@
+# container-notes
+
+在 macOS 上使用 [apple/container](https://github.com/apple/container) 的安裝與操作筆記。
+
+`container` 是 Apple 推出、以輕量虛擬機在 macOS 上執行 Linux 容器的工具。
+
+## 內容
+
+- [container-setup.md](container-setup.md) — 完整安裝、啟動、常用指令與疑難排解筆記
+
+## 快速開始
+
+```bash
+# 安裝（Homebrew）
+brew install container
+
+# 啟動服務
+container system start
+
+# 首次需設定預設 kernel
+container system kernel set --recommended
+
+# 測試
+container run --rm docker.io/library/alpine echo "hello from container"
+```
+
+詳細說明見 [container-setup.md](container-setup.md)。
+
+## 環境備註
+
+- 需 Apple Silicon（arm64）
+- 官方僅支援 macOS 26+；macOS 15 可透過 Homebrew 安裝執行，但網路功能受限