# インストールウィザード

Chamilo 2.0には、初期設定をガイドするウェブベースのインストールウィザードが含まれています。初めてプラットフォームにアクセスすると、ウィザードが自動的に実行されます。

## 開始する前に

以下の前提条件が満たされていることを確認してください：

1. サーバーがすべての[サーバー要件](/2.x-ja/gaido-1/admin-guide/installation/server-requirements.md)を満たしている。
2. Chamiloのパッケージ版（zipまたはtar.gz）をダウンロードしている。
3. ウェブサーバーが`public/`ディレクトリをドキュメントルートとして提供するように設定されている。
4. `.env`ファイルが存在し、空である（ウィザードがデータベース設定をガイドします）。

## ステップ1：インストール言語

![インストールウィザード ステップ1 — 言語選択](/files/eqAELtfIXuWFZTLyhIOd)

最初のステップでは、インストールプロセスの言語を選択できます。ドロップダウンから希望する言語を選んでください。

Chamiloが既存のインストールを検出した場合（アップグレードの場合）、移行ステータスを表示し、新規インストールの代わりにアップグレードパスを提供します。

## ステップ2：要件チェック

![インストールウィザード ステップ2 — PHPバージョン、拡張機能、ディレクトリ権限を示す要件チェック](/files/eFsPqjaXWiQyLmeUrrw8)

ウィザードはサーバー環境をチェックします：

* **PHPバージョン**が8.2以上である
* **必要なPHP拡張機能**がインストールされている（intl, gd, curl, zip, mbstring, xmlなど）
* **推奨されるPHP設定** — `date.timezone`が設定されており、適切なアップロード/メモリ制限がある
* **ディレクトリおよびファイルの権限** — `var/`, `config/`, および`public/upload/`がウェブサーバーによって書き込み可能である

要件が満たされていない場合、ウィザードは警告またはエラーを表示します。進む前にこれらを解決してください。

## ステップ3：ライセンス

![インストールウィザード ステップ3 — ライセンスの承諾](/files/Q7sMrDKjmzkbth2VSnFX)

このステップでは、GNU/GPLv3ライセンスが表示されます。進むには\*\*「承諾します」\*\*チェックボックスをオンにする必要があります。

オプションとして、**連絡先情報**セクションを展開して、組織の詳細（名前、メール、会社、国）を入力できます。これは任意であり、Chamiloコミュニティがプラットフォームを使用している人を理解するのに役立ちますが、非常にまれに近隣で開催されるイベントについて連絡を取ることも可能になります。

## ステップ4：データベース設定

![インストールウィザード ステップ4 — データベース接続の設定](/files/OBmK6qKbir6foGa9JEYk)

データベース接続の詳細を入力してください：

| フィールド           | 説明                                                |
| --------------- | ------------------------------------------------- |
| **データベースホスト**   | データベースサーバーのホスト名またはIP（例：`localhost`または`127.0.0.1`） |
| **データベースポート**   | デフォルト：MySQL/MariaDBの場合は3306                       |
| **データベース名**     | 使用するデータベースの名前（英数字とアンダースコアのみ）                      |
| **データベースユーザー**  | 指定したデータベースに対する完全な権限を持つデータベースユーザー                  |
| **データベースパスワード** | データベースユーザーのパスワード                                  |

**データベース接続を確認**をクリックしてテストします。接続が成功するまでウィザードは先に進めません。データベースがすでに存在する場合、警告が表示されます。

## ステップ5：構成設定

![インストールウィザード ステップ5 — 管理者アカウント、ポータル設定、メール設定](/files/2gAk8KpHKawr0uhgWrE1)

このステップでは、管理者アカウントの作成、ポータル設定、メール設定を組み合わせています。

### 管理者アカウント

| フィールド     | 説明                                                    |
| --------- | ----------------------------------------------------- |
| **ログイン**  | 管理者ユーザー名                                              |
| **パスワード** | 強力なパスワードを選択してください — このアカウントはプラットフォームへの完全なアクセス権を持っています |
| **名**     | 管理者の名                                                 |
| **姓**     | 管理者の姓                                                 |
| **メール**   | システム通知やパスワードリセットに使用されます                               |
| **電話**    | 任意の連絡先番号                                              |

これらの管理者情報は、Chamiloがサポート連絡先情報を入力するためにも使用されるため、インストールが完了した後に設定で再構成することを確認してください。

### ポータル設定

| フィールド                | 説明                                  |
| -------------------- | ----------------------------------- |
| **言語**               | デフォルトのインターフェース言語                    |
| **ポータル名**            | プラットフォームの名前（例：「私の組織LMS」）            |
| **会社略称**             | 組織の略称                               |
| **会社URL**            | 組織のウェブサイト                           |
| **暗号化方法**            | パスワードハッシュアルゴリズム — **bcrypt**が推奨されます |
| **自己登録を許可**          | はい / いいえ / 承認後                      |
| **トレーナーとしての自己登録を許可** | はい / いいえ                            |

### メール設定

メール設定セクションでは、メール送信方法（SMTP、Amazon SES、Mailjetなど）を設定し、メール配信をテストできます。詳細は[メール設定](/2.x-ja/gaido-1/admin-guide/installation/email-configuration.md)を参照してください。

これらの設定は、後から管理パネルから変更できます。

## ステップ6：インストール前の最終確認

![インストールウィザード ステップ6 — インストール前のすべての設定の確認](/files/UH8gvfsd470bgpJkVTYy)

このステップでは、入力したすべての内容の概要が表示され、確認することができます：

* 管理者認証情報（パスワードはデフォルトで非表示 — 目のアイコンをクリックすると表示されます）
* ポータル設定
* データベース接続の詳細

慎重に確認した後、**Chamiloをインストール**をクリックしてインストールを実行します。ウィザードはすべてのデータベーステーブルを作成し、初期データを入力し、プラットフォームを設定します。

## ステップ7：インストール完了

![インストールウィザード ステップ7 — セキュリティアドバイスとポータルリンクを含む完了画面](/files/vQyVW5wJpyA472pqFR3n)

インストールが正常に完了すると、ウィザードは以下の内容を表示します：

* **開始のためのアドバイス** — プラットフォームを探索するために最初のコースを作成することを提案します（管理者として、管理パネルからこれを行う必要があります）
* **セキュリティに関する推奨事項**：
  * `config/` ディレクトリを読み取り専用に設定する（`chmod 0555`）
  * `public/main/install/` ディレクトリを削除する
* 作成した管理者認証情報でログインするための**ポータルへのリンク**

## インストール後

ウィザードを完了した後：

* **インストーラーへのアクセスを削除または制限する** -- インストール後、ウィザードにはアクセスできないようにする必要があります。Chamiloは通常これを自動的にロックしますが、インストールURLに再訪問してもログインページにリダイレクトされることを確認してください。
* **メール配信を設定する** -- [メール設定](/2.x-ja/gaido-1/admin-guide/installation/email-configuration.md) を参照してください。
* **バックアップを設定する** -- コンテンツを追加する前に、データベースとファイルの自動バックアップを設定してください（Chamiloはこのためのソリューションを提供していませんが、var/フォルダとデータベースをコピーすることが最も重要な2つの要素です）。
* **セキュリティ設定を確認する** -- [セキュリティ設定](/2.x-ja/gaido-1/admin-guide/platform-settings/security-settings.md) を参照してください。

## トラブルシューティング

| 問題                      | 解決策                                                                      |
| ----------------------- | ------------------------------------------------------------------------ |
| インストールURLで空白のページが表示される  | PHPエラーログを確認してください。一時的に .env ファイルで `APP_ENV=dev` に変更すると、ブラウザでエラーが表示されます。  |
| データベース接続が失敗する           | 認証情報を確認し、データベースが存在することを確認し、データベースサーバーがウェブサーバーホストからの接続を許可していることを確認してください。 |
| 権限が拒否されるエラー             | `var/` がウェブサーバーユーザーによって書き込み可能であることを確認してください。                             |
| アセットが読み込まれない（CSS/JSがない） | `yarn install && yarn build` を実行してフロントエンドアセットをコンパイルしてください。               |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-ja/gaido-1/admin-guide/installation/installation-wizard.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
