coolify

Coolify - セルフホスト型 PaaS

重大：シークレットと .env

• 稼働中の .env ファイルや認証情報を、スキルフォルダー内に絶対に保存しないでください。
• .env.template ファイルは、スキル内の assets/ にのみ配置してください。
• 稼働中のシークレットは ~/.admin/.env に保存し、そこから参照してください。

目的：単一のサーバーに Coolify をインストールして運用し、Nixpacks、Dockerfile、または Docker Compose を使用してアプリをデプロイします。

ステップ 0：必要な情報を収集する（必須）

停止してください。インストールコマンドを実行する前に、すべてのパラメーターをユーザーから収集してください。

このチェックリストをコピーし、各項目を確認してください。

Required Parameters:
- [ ] COOLIFY_SERVER_IP     - Target server IP address
- [ ] SSH_USER              - SSH username (default: ubuntu)
- [ ] SSH_KEY_PATH          - Path to SSH private key (default: ~/.ssh/id_rsa)
- [ ] COOLIFY_ROOT_USER_EMAIL    - Admin email address
- [ ] COOLIFY_ROOT_USER_PASSWORD - Admin password (see requirements below)
- [ ] COOLIFY_INSTANCE_DOMAIN    - Main Coolify URL (e.g., coolify.example.com)
- [ ] COOLIFY_WILDCARD_DOMAIN    - Base domain for apps (e.g., example.com)

Conditional Parameters (ask user):
- [ ] Using Cloudflare Tunnel for HTTPS? (Y/N)
      If Y: CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID
- [ ] Need OAuth callbacks or webhooks? (Y/N)
      If Y: Will configure origin certificates
- [ ] Additional SSH public keys to authorize? (optional)

パスワードの要件（Coolify が適用）

• 8 文字以上
• 大文字を 1 文字以上含む（A-Z）
• 小文字を 1 文字以上含む（a-z）
• 数字を 1 文字以上含む（0-9）
• 記号を 1 文字以上含む（!@#$%^&*）

必須パラメーターがすべて確認されるまで、ステップ 1 に進まないでください。

---

ステップ 1：インストール方法を決定する

ユーザーの回答に基づき、適切なワークフローに従ってください。

方法 A：完全自動化（推奨）

使用する場合：新しいサーバー、HTTPS に Cloudflare Tunnel を使用する標準的なセットアップ。

1. references/ENHANCED_SETUP.md を読む
2. ステップ 0 で収集したすべてのパラメーターをエクスポートする
3. 拡張セットアップスクリプトを実行する

方法 B：手動インストール

使用する場合：既存のサーバー、カスタム要件、またはデバッグ。

1. references/INSTALLATION.md を読む
2. SSH コマンドを手順に沿って実行する
3. localhost 管理用に SSH キーを設定する（重要な手順）

---

ステップ 2：HTTPS アクセスをセキュリティで保護する

ステップ 0 の回答に基づき、アクセス方法を決定してください。

シナリオ	対応
Cloudflare Tunnel = Yes	references/cloudflare-tunnel.md を読む
OAuth/webhooks = Yes	references/cloudflare-origin-certificates.md も読む
IP アドレスへの直接アクセスのみ（開発用）	トンネルをスキップし、http://SERVER_IP:8000 でアクセスする

---

ステップ 3：インストールを確認する

次の確認チェックリストを実行してください。

Verification:
- [ ] Coolify UI accessible at configured domain or IP:8000
- [ ] Login with COOLIFY_ROOT_USER_EMAIL and password works
- [ ] Servers → localhost shows "Connected" (green)
- [ ] If tunnel: HTTPS working at COOLIFY_INSTANCE_DOMAIN

localhost が接続されていない場合：SSH キーの設定に失敗しています。references/INSTALLATION.md の「Coolify SSH Access の設定」セクションを参照してください。

---

ナビゲーション

詳細なリファレンス（1 階層のみ）：

• 手動での SSH インストール：references/INSTALLATION.md
• 完全自動化セットアップ：references/ENHANCED_SETUP.md
• 同梱スクリプト：references/BUNDLED_SCRIPTS.md
• Cloudflare Tunnel（ワイルドカード）：references/cloudflare-tunnel.md
• オリジン証明書（OAuth/webhooks）：references/cloudflare-origin-certificates.md
• Error 1033 のトラブルシューティング：references/TROUBLESHOOTING_CF1033.md

重要なルール

• Coolify の前に、必ず Compose プラグイン付きの Docker CE をインストールしてください。
• HTTPS（トンネルまたはリバースプロキシ）なしで、ポート 8000 をパブリックに公開しないでください。
• /data/coolify は変更せず、状態データとして扱ってください。
• localhost 管理用に、必ず Coolify の SSH キーを設定してください。

ログ連携

admin の一元化されたログ機能を使用して、主要な操作を記録してください。

log_admin "SUCCESS" "installation" "Installed Coolify" "version=4.x server=$SERVER_ID"
log_admin "SUCCESS" "system-change" "Configured Coolify" "domain=$DOMAIN"
log_admin "SUCCESS" "operation" "Deployed app via Coolify" "app=$APP_NAME"

関連スキル

• インベントリとプロビジョニングには devops。
• プロバイダー固有の VM セットアップには、プロバイダーのスキル（oci、hetzner、contabo、digital-ocean、vultr、linode）。
• WSL からの連携時にローカルの Docker/CLI をサポートするには admin。

リファレンス

• Coolify のドキュメント：https://coolify.io/docs
• Coolify の GitHub：https://github.com/coollabsio/coolify