> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/ja/gaido-1/admin-guide/installation/installation-wizard.md).

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

Chamilo 3.0 には、初期セットアップを案内する Web ベースのインストールウィザードが含まれています。ウィザードは、プラットフォームに初めてアクセスしたときに自動的に起動します。

## 開始する前に

次の前提条件を満たしていることを確認してください。

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

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

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

既存のインストールが検出された場合（アップグレード時）、ウィザードは移行の状態を表示し、新規インストールではなくアップグレードの手順を提示します。

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

ウィザードはサーバー環境を次の点で確認します。

* **PHP version** が 8.3、8.4、または 8.5 であること
* **Required PHP extensions** がインストールされていること（intl、gd、curl、zip、mbstring、xml など）
* **Recommended PHP settings** — `date.timezone` が設定され、十分なアップロード／メモリ制限があること
* **Directory and file permissions** — `var/`、`config/`、および `public/upload/` が Web サーバーから書き込み可能であること

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

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

このステップでは GNU/GPLv3 ライセンスが表示されます。続行するには **「I accept」** チェックボックスをオンにする必要があります。

任意で、**Contact information** セクションを展開し、組織に関する情報（名称、メール、会社、国）を入力できます。これは任意であり、Chamilo コミュニティが誰がプラットフォームを利用しているかを把握するのに役立ちますが、お近くで開催されるイベントについて *ごくまれに* ご連絡できるようにもなります。

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

データベース接続の詳細を入力します。

| Field                 | Description                                           |
| --------------------- | ----------------------------------------------------- |
| **Database host**     | データベースサーバーのホスト名または IP（例: `localhost` または `127.0.0.1`） |
| **Database port**     | デフォルト: MySQL/MariaDB では 3306                          |
| **Database name**     | 使用するデータベース名（英数字とアンダースコアのみ）                            |
| **Database user**     | 指定したデータベースに対する完全な権限を持つデータベースユーザー                      |
| **Database password** | データベースユーザーのパスワード                                      |

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

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

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

### 管理者アカウント

| Field          | Description                                    |
| -------------- | ---------------------------------------------- |
| **Login**      | 管理者のユーザー名                                      |
| **Password**   | 強力なパスワードを選んでください — このアカウントはプラットフォーム全体にアクセスできます |
| **First name** | 管理者の名                                          |
| **Last name**  | 管理者の姓                                          |
| **Email**      | システム通知およびパスワードリセットに使用されます                      |
| **Phone**      | 任意の連絡先電話番号                                     |

これらの管理者情報は、Chamilo がサポート連絡先の詳細を埋めるためにも使用されます。インストール完了後、設定画面で必ず再構成してください。

### ポータル設定

| Field                                  | Description                           |
| -------------------------------------- | ------------------------------------- |
| **Language**                           | 既定のインターフェース言語                         |
| **Portal name**                        | プラットフォームの名称（例: 「My Organization LMS」） |
| **Company short name**                 | 組織の略称                                 |
| **Company URL**                        | 組織の Web サイト                           |
| **Encryption method**                  | パスワードのハッシュアルゴリズム — **bcrypt** を推奨します  |
| **Allow self-registration**            | Yes / No / After approval             |
| **Allow self-registration as trainer** | Yes / No                              |

### メール設定

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

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

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

このステップでは、入力した内容の要約が表示されます。確認してください。

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

内容をよく確認したうえで、**Install Chamilo** をクリックしてインストールを実行します。ウィザードはすべてのデータベーステーブルを作成し、初期データを投入し、プラットフォームを設定します。

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

インストールが正常に完了すると、ウィザードには次の内容が表示されます。

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

## インストール後

ウィザードの完了後:

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

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

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