diff --git a/README.md b/README.md
index 46f5cd2..659eb8b 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,183 @@
-Helmチャート作成用のテンプレートです。
-カスタマイズしてお使いください。
+# WordPress with Nginx Helm Chart
+
+このHelmチャートは、Nginx + WordPress (PHP-FPM) 構成をKubernetes上にデプロイします。
+
+## アーキテクチャ
+
+- **Nginx**: リバースプロキシおよび静的ファイル配信
+- **WordPress (PHP-FPM)**: WordPressアプリケーション実行
+- **共有ボリューム**: Nginx と WordPress 間でファイルを共有
+
+## 前提条件
+
+- Kubernetes 1.19+
+- Helm 3.0+
+- PersistentVolume プロビジョナー（永続化を有効にする場合）
+- MySQL/MariaDB データベース（別途デプロイが必要）
+
+## インストール方法
+
+### 1. チャートの準備
+
+```bash
+# チャートディレクトリの作成
+mkdir -p wordpress-nginx/templates
+
+# 必要なファイルをコピー
+# Chart.yaml, values.yaml, templates/*
+```
+
+### 2. MySQLのデプロイ（必要な場合）
+
+```bash
+# Helm を使用して MySQL をデプロイ
+helm repo add bitnami https://charts.bitnami.com/bitnami
+helm install mysql bitnami/mysql \
+  --set auth.rootPassword=rootpassword \
+  --set auth.database=wordpress \
+  --set auth.username=wordpress \
+  --set auth.password=changeme
+```
+
+### 3. WordPressのデプロイ
+
+```bash
+# デフォルト値でインストール
+helm install my-wordpress ./wordpress-nginx
+
+# カスタム値でインストール
+helm install my-wordpress ./wordpress-nginx \
+  --set wordpress.dbPassword=your-secure-password \
+  --set service.type=LoadBalancer
+
+# values.yaml を使用
+helm install my-wordpress ./wordpress-nginx -f custom-values.yaml
+```
+
+## 設定パラメータ
+
+### 基本設定
+
+| パラメータ | 説明 | デフォルト値 |
+|-----------|------|-------------|
+| `replicaCount` | レプリカ数 | `2` |
+| `image.nginx.registry` | Nginxイメージレジストリ | `docker.io` |
+| `image.nginx.repository` | Nginxイメージリポジトリ | `nginx` |
+| `image.nginx.tag` | Nginxイメージタグ | `1.29.3-alpine-perl` |
+| `image.wordpress.registry` | WordPressイメージレジストリ | `docker.io` |
+| `image.wordpress.repository` | WordPressイメージリポジトリ | `wordpress` |
+| `image.wordpress.tag` | WordPressイメージタグ | `6.8.3-php8.4-fpm-alpine` |
+
+### WordPress設定
+
+| パラメータ | 説明 | デフォルト値 |
+|-----------|------|-------------|
+| `wordpress.dbHost` | データベースホスト | `mysql-service` |
+| `wordpress.dbName` | データベース名 | `wordpress` |
+| `wordpress.dbUser` | データベースユーザー | `wordpress` |
+| `wordpress.dbPassword` | データベースパスワード | `changeme` |
+| `wordpress.tablePrefix` | テーブルプレフィックス | `wp_` |
+
+### Service設定
+
+| パラメータ | 説明 | デフォルト値 |
+|-----------|------|-------------|
+| `service.type` | Serviceタイプ | `LoadBalancer` |
+| `service.port` | Serviceポート | `80` |
+
+### Ingress設定
+
+| パラメータ | 説明 | デフォルト値 |
+|-----------|------|-------------|
+| `ingress.enabled` | Ingressを有効化 | `false` |
+| `ingress.className` | IngressClass名 | `nginx` |
+| `ingress.hosts` | ホスト設定 | `wordpress.example.com` |
+
+### 永続化設定
+
+| パラメータ | 説明 | デフォルト値 |
+|-----------|------|-------------|
+| `persistence.enabled` | 永続化を有効化 | `true` |
+| `persistence.storageClass` | StorageClass | `""` |
+| `persistence.accessMode` | アクセスモード | `ReadWriteOnce` |
+| `persistence.size` | ストレージサイズ | `10Gi` |
+
+## 使用例
+
+### LoadBalancerでの公開
+
+```bash
+helm install my-wordpress ./wordpress-nginx \
+  --set service.type=LoadBalancer \
+  --set wordpress.dbPassword=SecurePassword123
+```
+
+### Ingressでの公開
+
+```bash
+helm install my-wordpress ./wordpress-nginx \
+  --set ingress.enabled=true \
+  --set ingress.hosts[0].host=wordpress.example.com \
+  --set ingress.hosts[0].paths[0].path=/ \
+  --set ingress.hosts[0].paths[0].pathType=Prefix \
+  --set service.type=ClusterIP
+```
+
+### リソース制限のカスタマイズ
+
+```bash
+helm install my-wordpress ./wordpress-nginx \
+  --set resources.nginx.limits.memory=1Gi \
+  --set resources.wordpress.limits.memory=2Gi
+```
+
+## アップグレード
+
+```bash
+# 設定を変更してアップグレード
+helm upgrade my-wordpress ./wordpress-nginx \
+  --set wordpress.dbPassword=NewPassword
+
+# values.yamlを使用してアップグレード
+helm upgrade my-wordpress ./wordpress-nginx -f custom-values.yaml
+```
+
+## アンインストール
+
+```bash
+helm uninstall my-wordpress
+```
+
+## トラブルシューティング
+
+### Podの状態確認
+
+```bash
+kubectl get pods -l app.kubernetes.io/name=wordpress-nginx
+kubectl describe pod <pod-name>
+kubectl logs <pod-name> -c nginx
+kubectl logs <pod-name> -c wordpress
+```
+
+### データベース接続の確認
+
+```bash
+kubectl exec -it <pod-name> -c wordpress -- wp db check
+```
+
+### 永続ボリュームの確認
+
+```bash
+kubectl get pvc
+kubectl describe pvc <pvc-name>
+```
+
+## セキュリティ考慮事項
+
+本番環境では以下を必ず実施してください:
+
+1. **データベースパスワードの保護**: Kubernetes Secretを使用
+2. **HTTPS の有効化**: cert-manager等でTLS証明書を設定
+3. **リソース制限の設定**: 適切なresources設定
+4. **定期的なバックアップ**: PVCのスナップショット等
+5. **セキュリティアップデート**: イメージの定期的な更新